Skip to content

Commit 40c4dd1

Browse files
authored
Merge branch 'master' into update-passwords
2 parents b765094 + b6c7409 commit 40c4dd1

16 files changed

+10317
-9232
lines changed

content/before-you-open-a-support-ticket.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,10 @@ A Live USB can be used as a rescue disk. This will provide us an outside OS envi
3838

3939
We have an article to guide you through creating [Live USBs here.](/articles/live-disk)
4040

41+
## Local repair and upgrades
42+
43+
We offer techincal documenation (tech-docs such as service manuals) in this [article](/articles/guides).
44+
4145
## Common Issue Sources
4246

4347
### Software

content/customize-gnome.md

Lines changed: 6 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ section: software
1818
tableOfContents: true
1919
---
2020

21-
**Please note**: Pop_OS! 22.04 is based on GNOME 42 so the extension **must** support GNOME 42.
21+
**Please note**: Pop!\_OS 22.04 is based on GNOME 42 so the extension **must** support GNOME 42.
2222

2323
The GNOME desktop environment is highly customizable. With a few extensions, the desktop can look and feel like many other operating system's desktops. Launcher bars can be added, window lists can be used, and the overall look and feel of the desktop can be changed.
2424

@@ -30,7 +30,7 @@ We will share some of the more popular extensions, but there are many more to ch
3030

3131
## User Themes
3232

33-
**Please note**: If you are using a custom GNOME theme in Pop_OS! 22.04, it **must** support GTK 4.
33+
**Please note**: If you are using a custom GNOME theme in Pop!\_OS 22.04, it **must** support GTK 4.
3434

3535
[User Themes](https://extensions.gnome.org/extension/19/user-themes/)
3636

@@ -44,6 +44,8 @@ This extension allows for the desktop to be themed in further ways than default.
4444

4545
![dash-to-dock](/images/customize-gnome/dash-to-dock.png)
4646

47+
>**Note:** Starting with version 22.04, Pop!\_OS includes Cosmic Dock, which is forked from Dash to Dock. GNOME Settings has options for customization in Settings -> Desktop -> Dock. You will want to disable Cosmic Dock in the Extension application if adding Dash to Dock.
48+
4749
This extension brings a launcher similar to the Unity launcher on the left side, or the macOS launcher on the bottom. It is highly customizable and allows for different locations, styles, sizes, and layouts. This is included by default in Ubuntu 18.04 and can be added to Pop!_OS.
4850

4951
---
@@ -68,23 +70,15 @@ This extension adds a window list to the bottom of the monitors. This shows wha
6870

6971
---
7072

71-
## Gnomenu
72-
73-
[Gnomenu](https://extensions.gnome.org/extension/608/gnomenu/)
74-
75-
![gnomenu](/images/customize-gnome/gnomenu.png)
76-
77-
This extension adds a traditionally styled, full featured menu to GNOME. This menu is similar to a traditional Window's Start Menu, and is highly customizable for how it looks and functions.
78-
79-
---
80-
8173
## Appindicator Support and TopIcons Plus
8274

8375
[Appindicator Support](https://extensions.gnome.org/extension/615/appindicator-support/)
8476
[Top Icons](https://extensions.gnome.org/extension/1031/topicons/)
8577

8678
![topicons](/images/customize-gnome/topicons.png)
8779

80+
>**Note:** Starting with Pop!\_OS 22.04 the Ubuntu fork of this extension is included by default.
81+
8882
Appindicator Support and TopIcons Plus both serve to add the ability for programs to use an indicator icon to show they are running. This functionality has been removed in recent versions of GNOME, and an extension is needed for the functionality. These 2 programs work slightly differently, and work better in some setups vs. others. If one doesn't work, try the other one.
8983

9084
See [blogs.gnome.org](https://blogs.gnome.org/aday/2017/08/31/status-icons-and-gnome/) for more background on the removal of the support from default GNOME environment.
@@ -121,14 +115,6 @@ CPU power meter allows for quick switching of various CPU frequency settings.
121115

122116
---
123117

124-
## Extension Update Notifier
125-
126-
[Extension Update Notifier](https://extensions.gnome.org/extension/1166/extension-update-notifier/)
127-
128-
This extension will check the various installed extensions and present a notification that there is an update to the extensions. Extensions are not automatically updated, so this extension provides the next best option.
129-
130-
---
131-
132118
## Lock Keys
133119

134120
[Lock keys](https://extensions.gnome.org/extension/36/lock-keys/)

content/fan-noise.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
---
2+
title: System Fan Noise and Expectactions
3+
description: >
4+
Ways to manage fan noise and design constraints.
5+
keywords:
6+
- Fans
7+
- Loud
8+
9+
facebookImage: /_social/article
10+
twitterImage: /_social/article
11+
12+
hidden: false
13+
section: software
14+
tableOfContents: true
15+
---
16+
17+
## Noise Levels
18+
19+
System76 sets custom fan curves for laptops to maximize their performance while minimizing fan noise. Current firmware keeps the fan off until 65°C and will ramp the fan speeds to max speed by 90°C.
20+
21+
### Monitoring Fan Speeds
22+
23+
Fan Speeds can be monitored with <u>psensor</u>, which can be installed from either the <u>Pop!_Shop</u> or the <u>Ubuntu Software</u> applications. Below is an example from a Oryx Pro (the number of cores/threads/GPU present will be different depending on the system).
24+
25+
![psensor on an oryp7](/images/fan-noise/psensor-oryp7.png)
26+
27+
### Fan Modes
28+
29+
Our [Open Firmware laptops](/articles/open-firmware-systems) have fan controls to swap between max or automatic thermal control. Use Fn+1 to toggle between the modes. (Your model will show support on the key section of their [tech-docs](https://tech-docs.system76.com)).
30+
31+
### Easy settings to effect fan noise
32+
33+
Fan speed is based on thermal output of the system. There are some settings that will indirectly limit how much heat is created during use:
34+
35+
1. Run the laptop while on battery: This will limit power consumption for the CPU and GPU and will lower thermal output.
36+
2. Set the laptop to Battery Life mode in either Power Profiles in the system menu or using `system76-power`. This limits the CPU's boost frequency, a side effect is to also limit how much heat is created.

content/guides.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,9 @@ keywords:
77
- Guides
88
- Quickstart
99
- Setup
10+
- repair guide
11+
- internal view
12+
- disassembly
1013
- System76
1114

1215
facebookImage: /_social/article

content/laptop-battery-thresholds.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -97,3 +97,5 @@ To adjust the thresholds, reboot the computer and enter the UEFI setup utility b
9797
![Enabling FlexiCharger](/images/laptop-charging-thresholds/flexicharger.jpg)
9898

9999
Once configured, save and exit the setup utility. The thresholds can be disabled at any time by setting FlexiCharger back to Disabled.
100+
101+
**Note:** The pang12 and pang13 do not support FlexiCharging.

content/open-firmware-systems.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -37,23 +37,23 @@ The source code for our Open EC can be found [here](https://github.com/system76/
3737

3838
| System | Open Firmware | Open EC |
3939
|:------:|:-------------:|:-------:|
40-
| addw2 | Yes\* | Yes\* |
41-
| bonw14 | Yes | Yes |
42-
| darp8 | Yes | Yes |
43-
| darp7 | Yes | Yes |
44-
| darp6 | Yes | Yes\* |
45-
| galp6 | Yes | Yes |
46-
| galp5 | Yes | Yes |
47-
| galp4 | Yes | No |
48-
| gaze17 | Yes | Yes |
49-
| gaze16 | Yes | Yes |
50-
| gaze15 | Yes\* | Yes\* |
51-
| lemp11 | Yes | Yes |
52-
| lemp10 | Yes | Yes |
53-
| lemp9 | Yes | Yes |
54-
| oryp9 | Yes | Yes |
55-
| oryp8 | Yes | Yes |
56-
| oryp7 | Yes | Yes |
57-
| oryp6 | Yes | Yes |
40+
| Adder WS (addw1) | No | No |
41+
| Adder WS (addw2) | Yes\* | Yes\* |
42+
| Adder WS (addw3 and newer) | Yes | Yes |
43+
| Bonobo WS (bonw13 and older) | No | No |
44+
| Bonobo WS (bonw14 and newer) | Yes | Yes |
45+
| Darter Pro (darp5 and older) | No | No |
46+
| Darter Pro (darp6) | Yes | Yes\* |
47+
| Darter Pro (darp7 and newer) | Yes | Yes |
48+
| Galago Pro (galp3 and older) | No | No |
49+
| Galago Pro (galp4) | Yes | No |
50+
| Galago Pro (galp5 and newer) | Yes | Yes |
51+
| Gazelle (gaze14 and older) | No | No |
52+
| Gazelle (gaze15) | Yes\* | Yes\* |
53+
| Gazelle (gaze16 and newer) | Yes | Yes |
54+
| Lemur Pro (lemp8 and older) | No | No |
55+
| Lemur Pro (lemp9 and newer) | Yes | Yes |
56+
| Oryx Pro (oryp5 and older) | No | No |
57+
| Oryx Pro (oryp6 and newer) | Yes | Yes |
5858

5959
\* These models shipped with closed firmware/EC, but have since been updated to Open Firmware/EC. [This article](/articles/transition-firmware) can be used to move your system from closed to Open Firmware/EC.

content/package-manager-pop.md

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ section: software-troubleshooting
1818
tableOfContents: true
1919
---
2020

21-
## Apt/Dpkg (system-wide packages)
21+
## APT/Dpkg (system-wide packages)
2222

2323
If your system complains about a failed upgrade, package manager conflicts, broken upgrades, or other package-related issues, there are several common fixes to these problems. Some package manager issues can be resolved with the graphical update program, but many require the command line. Try running these commands to fix your package manager:
2424

@@ -112,11 +112,11 @@ apt-mark showhold
112112

113113
If the Terminal returns nothing, no packages are held.
114114

115-
If the Pop!_Shop indicates that some remote repositories can't be reached, open [Repoman](/articles/manage-repos-pop) and look in the **Extra Sources** page for the broken repository. Either disable or remove the repository, or search for the software vendor to determine what has happened to their software server. Sometimes the version of the repo (xenial, bionic, focal, groovy, etc) needs changed to match the current version of the operating system.
115+
If the <u>Pop!_Shop</u> indicates that some remote repositories can't be reached, open [Repoman](/articles/manage-repos-pop) and look in the **Extra Sources** page for the broken repository. Either disable or remove the repository, or search for the software vendor to determine what has happened to their software server. Sometimes the version of the repo (xenial, bionic, focal, groovy, etc) needs changed to match the current version of the operating system.
116116

117117
## Flatpak
118118

119-
If the Pop!_Shop is showing an update available, but there are no updates listed on the update page, there may be a Flatpak runtime (a backend program that another Flatpak depends on) with an update available. Run these commands to update all Flatpaks and remove any Flatpak runtimes that are no longer required by any installed programs:
119+
If the <u>Pop!_Shop</u> is showing an update available, but there are no updates listed on the update page, there may be a Flatpak runtime (a backend program that another Flatpak depends on) with an update available. Run these commands to update all Flatpaks and remove any Flatpak runtimes that are no longer required by any installed programs:
120120

121121
```bash
122122
flatpak update
@@ -131,3 +131,22 @@ The program <u>Synaptic Package Manager</u> is a very powerful GUI frontend for
131131
```bash
132132
sudo apt install synaptic
133133
```
134+
135+
## Sending information to support
136+
137+
The following commands will save the output to `upgrade.txt` and `sources.txt` so that they can be attached to support emails.
138+
139+
```bash
140+
sudo apt clean | tee -a ~/upgrade.txt
141+
sudo apt update -m | tee -a ~/upgrade.txt
142+
sudo dpkg --configure -a | tee -a ~/upgrade.txt
143+
sudo apt install -f | tee -a ~/upgrade.txt
144+
sudo apt full-upgrade | tee -a ~/upgrade.txt
145+
sudo apt autoremove --purge | tee -a ~/upgrade.txt
146+
147+
cat /etc/apt/sources.list | tee -a ~/sources.txt
148+
cat /etc/apt/sources.list.d/* | tee -a ~/sources.txt
149+
ls /etc/apt/sources.list.d/ | tee -a ~/sources.txt
150+
cat /etc/apt/sources.list.d/system.sources | tee -a ~/sources.txt
151+
cat /etc/apt/sources.list.d/pop-os-apps.sources | tee -a ~/sources.txt
152+
```

content/package-manager-ubuntu.md

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,8 @@ section: software-troubleshooting
1818
tableOfContents: true
1919
---
2020

21+
## APT/Dpkg (system-wide packages)
22+
2123
If your system complains about a failed upgrade, package manager conflicts, broken upgrades, or other package-related issues, there are several common fixes to these problems. Some package manager issues can be resolved with the graphical update program, but many require the command line. If you get the red circle in the status bar, run these commands to fix your package manager:
2224

2325
```bash
@@ -112,7 +114,7 @@ apt-mark showhold
112114

113115
If the Terminal returns nothing, no packages are held.
114116

115-
If the Pop!_Shop indicates that some remote repositories can't be reached, open [Repoman](/articles/manage-repos-pop) and look in the **Extra Sources** page for the broken repository. Either disable or remove the repository, or search for the software vendor to determine what has happened to their software server. Sometimes the version of the repo (xenial, bionic, focal, groovy, etc) needs changed to match the current version of the operating system.
117+
If the Ubuntu Store indicates that some remote repositories can't be reached, open <u>Software & Updates</u> and look in the **Extra Sources** page for the broken repository. Either disable or remove the repository, or search for the software vendor to determine what has happened to their software server. Sometimes the version of the repo (xenial, bionic, focal, groovy, etc) needs changed to match the current version of the operating system.
116118

117119
## Snap Pacakges
118120

@@ -136,3 +138,22 @@ The program <u>Synaptic</u> is a very powerful GUI of the package manager. Pack
136138
```bash
137139
sudo apt install synaptic
138140
```
141+
142+
## Sending information to support
143+
144+
The following commands will save the output to `upgrade.txt` and `sources.txt` so that they can be attached to support emails.
145+
146+
```bash
147+
sudo apt clean | tee -a ~/upgrade.txt
148+
sudo apt update -m | tee -a ~/upgrade.txt
149+
sudo dpkg --configure -a | tee -a ~/upgrade.txt
150+
sudo apt install -f | tee -a ~/upgrade.txt
151+
sudo apt full-upgrade | tee -a ~/upgrade.txt
152+
sudo apt autoremove --purge | tee -a ~/upgrade.txt
153+
154+
cat /etc/apt/sources.list | tee -a ~/sources.txt
155+
cat /etc/apt/sources.list.d/* | tee -a ~/sources.txt
156+
ls /etc/apt/sources.list.d/ | tee -a ~/sources.txt
157+
cat /etc/apt/sources.list.d/system.sources | tee -a ~/sources.txt
158+
cat /etc/apt/sources.list.d/pop-os-apps.sources | tee -a ~/sources.txt
159+
```

content/system-firmware.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -136,7 +136,8 @@ Identify the EFI partition in the list. (The EFI partition is usually the first
136136
#### For NVMe Drives
137137

138138
```bash
139-
sudo apt install system76-driver
139+
sudo apt update
140+
sudo apt install system76-driver system76-firmware
140141
sudo mkdir -p /boot/efi
141142
sudo mount /dev/nvme0n1p1 /boot/efi
142143
gnome-control-center firmware
@@ -147,7 +148,8 @@ Where `/dev/nvme0n1p1` is the EFI system partition.
147148
#### For SATA Drives
148149

149150
```bash
150-
sudo apt install system76-driver
151+
sudo apt update
152+
sudo apt install system76-driver system76-firmware
151153
sudo mkdir -p /boot/efi
152154
sudo mount /dev/sda1 /boot/efi
153155
gnome-control-center firmware

content/system76-driver.md

Lines changed: 10 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -20,30 +20,6 @@ This guide will show you how to add the System76 software repository and install
2020

2121
Please note these steps are not necessary in Pop!\_OS, which includes the repository and the appropriate drivers installed by default.
2222

23-
## Adding the Apt Preferences File
24-
25-
If you are running Ubuntu 19.10 or later, you will need to manually add an apt preferences file to "pin" the System76 repository. This will tell apt to prefer System76 packages over standard Ubuntu packages. Installing the System76 Driver will not be possible until this step is completed.
26-
27-
Create the apt preferences file here:
28-
29-
```bash
30-
sudo gedit /etc/apt/preferences.d/system76-apt-preferences
31-
```
32-
33-
Add the following six lines (seven if you count the space in the middle):
34-
35-
```bash
36-
Package: *
37-
Pin: release o=LP-PPA-system76-dev-stable
38-
Pin-Priority: 1001
39-
40-
Package: *
41-
Pin: release o=LP-PPA-system76-dev-pre-stable
42-
Pin-Priority: 1001
43-
```
44-
45-
Save the file. Now you should be able to install the System76 Driver as described below.
46-
4723
## Installing the Driver
4824

4925
To install our Driver you need to run the following commands in the Terminal:
@@ -56,7 +32,7 @@ sudo apt install system76-driver
5632

5733
This installs the System76 driver and related utilities which are needed to enable full functionality for your system.
5834

59-
## Installing the System76 NVIDIA Driver for Systems with NVIDIA GPUs
35+
### Installing the System76 NVIDIA Driver for Systems with NVIDIA GPUs
6036

6137
If your system has an NVIDIA graphics card, you will want to go ahead and use this command to install the System76 Driver with NVIDIA graphics drivers built-in:
6238

@@ -66,7 +42,7 @@ sudo apt-get install system76-driver-nvidia
6642

6743
In addition to the standard packages, that will pull in the latest NVIDIA drivers as packaged by System76, and all related packages needed to take full advantage of your dedicated NVIDIA graphics card.
6844

69-
### Install System76 Driver on Other Operating Systems
45+
## Install System76 Driver on Other Operating Systems
7046

7147
**DISCLAIMER:** This section explains how to install the <u>System76 Driver</u> on Arch and Fedora.
7248

@@ -78,7 +54,7 @@ The support team typically makes a best-effort attempt to offer direction or tro
7854

7955
**Note:** At this time, it is recommended to use the NVIDIA driver from the Arch and Fedora repositories.
8056

81-
### Arch - Manual install
57+
## Arch - Manual install
8258

8359
First, install some build dependencies for the <u>System76 Firmware Daemon</u>, <u>System76 Driver</u> and the <u>Firmware Manager</u> packages:
8460

@@ -91,8 +67,8 @@ sudo pacman -S --needed base-devel git linux-headers
9167
These commands will clone, build and install the <u>System76 Firmware Daemon</u> service.
9268

9369
```bash
94-
git clone https://aur.archlinux.org/system76-firmware-daemon.git
95-
cd system76-firmware-daemon
70+
git clone https://aur.archlinux.org/system76-firmware.git
71+
cd system76-firmware
9672
makepkg -srcif
9773
sudo systemctl enable --now system76-firmware-daemon
9874
sudo gpasswd -a $USER adm
@@ -121,7 +97,7 @@ sudo systemctl enable --now system76
12197

12298
Reboot the system so that our user is added to the `adm` group, then we are done!
12399

124-
### Arch - Using an AUR helper
100+
## Arch - Using an AUR helper
125101

126102
Arch users can alternatively use an AUR helper to automate some of the steps for installation and upgrading; in this example, we'll use the <u>Paru</u> application. <u>Paru</u> can be installed from the AUR using these commands:
127103

@@ -134,13 +110,13 @@ makepkg -si
134110
**Note:** By default, <u>Paru</u> uses VIM keyboard shortcuts, so when you see a `:`, press the <kbd>q</kbd> key to continue. You may also need to confirm the import of some public keys using the <kbd>y</kbd> key.
135111

136112
```bash
137-
paru -S system76-firmware-daemon
113+
paru -S system76-firmware-daemon-git
138114
sudo systemctl enable --now system76-firmware-daemon
139115
sudo gpasswd -a $USER adm
140116
```
141117

142118
```bash
143-
paru -S firmware-manager
119+
paru -S firmware-manager-git
144120
```
145121

146122
```bash
@@ -149,12 +125,11 @@ paru -S system76-driver
149125
sudo systemctl enable --now system76
150126
```
151127

152-
### Fedora
128+
## Fedora
153129

154130
Run these commands in a <u>Terminal</u> to enable the [community Fedora COPR](https://copr.fedorainfracloud.org/coprs/szydell/system76/) and install the <u>System76 Driver</u> :
155131

156132
```bash
157133
sudo dnf copr enable szydell/system76
158-
sudo dnf install system76*
159-
sudo systemctl enable --now com.system76.PowerDaemon.service
134+
sudo dnf install system76-driver
160135
```

0 commit comments

Comments
 (0)