Skip to content

Commit 7e190f8

Browse files
authored
Merge branch 'master' into pang12-flex
2 parents 00bb426 + 36248f3 commit 7e190f8

File tree

10 files changed

+10254
-9214
lines changed

10 files changed

+10254
-9214
lines changed

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/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
```

content/system76-software.md

Lines changed: 25 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -34,17 +34,17 @@ If you want to use an AUR helper like [Paru](https://github.com/Morganamilo/paru
3434
This command will install all of the packages using <u>Paru</u>.
3535

3636
```bash
37-
paru -S system76-firmware-daemon system76-firmware firmware-manager system76-power gnome-shell-extension-system76-power-git system76-driver system76-dkms system76-acpi-dkms
37+
paru -S system76-firmware-daemon system76-firmware firmware-manager system76-power gnome-shell-extension-system76-power-git system76-driver system76-dkms system76-acpi-dkms system76-io-dkms
3838
```
3939

40-
This command will install `firmware-manager` using <u>Paru</u>.
41-
4240
**NOTE:** choose the first software option after running the <u>Paru</u> command.
4341

4442
```bash
4543
paru -S firmware-manager
4644
```
4745

46+
This command will install <u>firmware-manager</u> using <u>Paru</u>.
47+
4848
### System76 DKMS
4949

5050
This package is needed for hotkeys and fan(s) on Closed Firmware systems.
@@ -155,7 +155,14 @@ paru -S system76-acpi-oled
155155

156156
## Fedora
157157

158-
Be sure to install the <u>System76 Driver</u> first. The steps to do that are [here](/articles/system76-driver).
158+
Be sure to install the <u>System76 Driver</u> first. The steps to do that are [here](/articles/system76-driver). The commands below will install every system76 package using the wildcard(*) use the other sections to install each package on it's own if you do not want all of the packages.
159+
160+
```bash
161+
sudo dnf install system76* firmware-manager
162+
sudo systemctl enable --now system76-firmware-daemon
163+
sudo systemctl mask power-profiles-daemon.service
164+
sudo gpasswd -a $USER adm
165+
```
159166

160167
### System76 Firmware Manager in Fedora
161168

@@ -167,6 +174,12 @@ sudo systemctl enable --now system76-firmware-daemon
167174
sudo gpasswd -a $USER adm
168175
```
169176

177+
**NOTE:** After enabling the dkms systemd service for any of the DKMS packages you will need to reboot the system:
178+
179+
```bash
180+
sudo systemctl reboot
181+
```
182+
170183
### System76 Power in Fedora
171184

172185
Use these commands to install the <u>System76 Power</u> package and enable the service:
@@ -184,6 +197,8 @@ sudo systemctl mask power-profiles-daemon.service
184197

185198
### System76 Power GNOME Shell Extension in Fedora
186199

200+
**NOTE:** Fedora uses GNOME 44 and some of the internal APIs are missing that are used in this extention. The API change happend with the release of GNOME 43. Pull requests that update to newer APIs are very welcome!
201+
187202
These commands will download the source code for the application, build it, install it and install the <u>Extensions</u> application:
188203

189204
```bash
@@ -221,12 +236,6 @@ sudo dnf install system76-acpi-dkms
221236
sudo systemctl enable dkms
222237
```
223238

224-
**NOTE:** After enabling the dkms systemd service for either the <u>System76 DKMS</u> or the <u>System76 ACPI DKMS</u> package you will need to reboot the system:
225-
226-
```bash
227-
sudo systemctl reboot
228-
```
229-
230239
### System76 Thelio Io DKMS in Fedora
231240

232241
This command will be used to install the <u>System76 Io DKMS</u> which is used for the Thelio Io board:
@@ -235,6 +244,12 @@ This command will be used to install the <u>System76 Io DKMS</u> which is used f
235244
sudo dnf install system76-io-dkms
236245
```
237246

247+
**NOTE:** After enabling the dkms systemd service for any of the DKMS packages you will need to reboot the system:
248+
249+
```bash
250+
sudo systemctl reboot
251+
```
252+
238253
### System76 OLED in Fedora
239254

240255
This command will be used to install the <u>System76 OLED</u> which is used for systems with OLED panels:

content/wireless.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -203,3 +203,7 @@ The newest version of the <u>linux-firmware</u> package, which contains the iwlw
203203
[mirrors.kernel.org/ubuntu/pool/main/l/linux-firmware](https://mirrors.kernel.org/ubuntu/pool/main/l/linux-firmware)
204204

205205
Sometimes the newest version of the firmware will clear up occasional bugs. Please download the newest `.deb` package.
206+
207+
### Windows Dual Boot
208+
209+
If you are dual booting Windows, you may lose access to your wifi card entirely after running driver/OS updates in Windows. You may be able to gain access to your wifi card again by disabling "Fast Startup" in the Windows power options before booting back into Pop!_OS.

layouts/default.vue

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@
4343
url-contact="https://system76.com/contact"
4444
url-about="https://system76.com/about"
4545
url-careers="https://system76.com/careers"
46-
url-specials="https://system76.com/specials"
46+
url-sustainability="https://system76.com/sustainability"
4747
url-shipping="https://system76.com/shipping"
4848
url-privacy="https://system76.com/privacy-and-legal"
4949
/>

0 commit comments

Comments
 (0)