Skip to content

Commit 288802f

Browse files
committed
managing-apps: Better organize Flatpak vs deb explanations
1 parent 0a8c547 commit 288802f

1 file changed

Lines changed: 80 additions & 44 deletions

File tree

content/managing-apps.md

Lines changed: 80 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,20 @@ section: pop
1717
tableOfContents: true
1818
---
1919

20+
## Types of Packages in Pop!_OS
21+
22+
There are multiple package formats that can be used for installing applications on Pop!_OS.
23+
24+
- **Flatpaks** are a modern type of package that utilize containerization and sandboxing for increased stability and security. Installing a Flatpak also installs all of its dependencies and libraries, and different Flatpak applications can use different versions of their dependencies at the same time if necessary.
25+
- [Flathub](https://flathub.org/) is the default source for most Flatpak applications in Pop!_OS.
26+
- Flatpak applications are generally more up-to-date than system (.deb) packages.
27+
- In Pop!_OS, Flatpak applications will only be available to the user who installed them by default.
28+
29+
- **.deb files** (short for Debian files), sometimes called "system packages," are an older packaging format that forms the base of the operating system. They're installed by the `dpkg` or `apt` utilities (with `apt` also handling dependency resolution). Only one version of a dependency can usually be installed at a time with .deb files.
30+
- [The Ubuntu repositories](https://packages.ubuntu.com/) are the primary source of non-default .deb packages available to install in Pop!_OS and Ubuntu. (System packages installed by default are sometimes sourced from the first-party Pop!_OS repositories instead.)
31+
- System (.deb) packages sometimes offer older versions of applications than Flatpaks, since applications installed from the Ubuntu repositories only receive feature updates during major version upgrades of Pop!_OS.
32+
- Installed system (.deb) packages are available to all user accounts on the computer. For this reason, only administrators can install or update .deb packages.
33+
2034
## Using the COSMIC Store
2135

2236
### Installing an Application
@@ -25,38 +39,36 @@ COSMIC includes a graphical user interface (GUI) called the COSMIC Store for eas
2539

2640
1. Open the COSMIC Store by clicking the icon in the dock, or by pressing `Super` to open the launcher and then searching for “COSMIC Store”.
2741

28-
![cosmic store icon](/images/managing-apps/IURA_24_1.png)
42+
![COSMIC Store icon in the Dock](/images/managing-apps/cosmic-store-icon.png)
2943

3044
2. Explore apps or type the application name in the search field.
3145

32-
![cosmic store search](/images/managing-apps/IURA_24_2.png)
46+
![Search bar in the COSMIC Store](/images/managing-apps/cosmic-store-search.png)
3347

34-
3. Select the system or flathub version.
35-
- Flatpak packages (installed from Flathub by default) are generally more up-to-date. They'll only be available to the user who installed them.
36-
- System (.deb) packages (installed from the Ubuntu or Pop!_OS repositories by default) are available to all user accounts on the computer.
48+
3. Select the system (.deb) or Flathub (Flatpak) version.
3749

38-
![app download type version](/images/managing-apps/IURA_24_3.png)
50+
![Selecting the app type in the COSMIC Store](/images/managing-apps/cosmic-store-select-type.png)
3951

4052
### Installing an Application Not Listed in the COSMIC Store
4153

4254
The COSMIC Store lists applications available in the configurated software repositories. By default, these are [Flathub](https://flathub.org), [the Ubuntu repositories](https://packages.ubuntu.com), and the first-party Pop!\_OS repositories. If an application isn't available from one of these repositories, you can use the web to search for and install it from another source instead.
4355

4456
1. Search for the application download link and instructions online.
4557

46-
![cosmic app google search](/images/managing-apps/IURA_24_4.png)
58+
![Pop!_OS 24.04 browser search](/images/managing-apps/browser-search-2404.png)
4759

4860
2. Download the application. When given multiple options of file type, look for a 64-bit .deb or Debian/Ubuntu option.
4961

50-
![cosmic deb file on download](/images/managing-apps/IURA_22_5.png)
62+
![Selecting the .deb type on the download webpage](/images/managing-apps/browser-select-type.png)
5163

5264
3. After downloading, go to the Downloads folder and double-click the .deb file.
5365

54-
![cosmic store icon](/images/managing-apps/IURA_24_5.png)
66+
![Downloaded .deb file in Pop!_OS 24.04](/images/managing-apps/downloaded-deb-file-2404.png)
5567

5668
4. The COSMIC Store will open and present you with the option to install the file.
5769
- When installing this way, the application may install a new repository so COSMIC Store can check for updates in the future, or you may need to download updates manually the same way you downloaded the initial installer.
5870

59-
![cosmic store downloaded file installation](/images/managing-apps/IURA_24_6.png)
71+
![Installing a .deb file with the COSMIC Store](/images/managing-apps/cosmic-store-file-install.png)
6072

6173
### Managing Repositories
6274

@@ -66,31 +78,31 @@ You can add, remove, and edit software repositories using Repoman. This includes
6678

6779
1. Press `Super` to open the launcher, then search for “Repoman".
6880

69-
![cosmic repoman](/images/managing-apps/IURA_24_7.png)
81+
![Searching for Repoman in the COSMIC Launcher](/images/managing-apps/repoman-launcher.png)
7082

7183
2. Click on the Extra Sources tab to manage .deb repositories (PPAs), or the Flatpak tab to manage Flatpak repositories.
7284

73-
![cosmic repoman extra sources](/images/managing-apps/IURA_24_8.png)
85+
![Repoman's Extra Sources page in Pop!_OS 24.04](/images/managing-apps/repoman-extra-sources-2404.png)
7486

7587
#### Adding a Repository
7688

7789
1. Click the `+` button in the bottom-left corner.
7890

79-
![cosmic repoman add icon](/images/managing-apps/IURA_24_9.png)
91+
![Add button in Repoman (24.04)](/images/managing-apps/repoman-add-button-2404.png)
8092

8193
2. Enter the source details for the repository and click Add.
8294

83-
![cosmic repoman add source](/images/managing-apps/IURA_24_10.png)
95+
![Adding a source in Repoman (24.04)](/images/managing-apps/repoman-adding-2404.png)
8496

8597
3. The repository will appear in the sources list.
8698

87-
![cosmic repoman source list](/images/managing-apps/IURA_24_11.png)
99+
![Added source in Repoman (24.04)](/images/managing-apps/repoman-added-2404.png)
88100

89101
#### Removing a Repository
90102

91103
Select a repository from the list, then click on the trashcan icon to delete the repository.
92104

93-
![cosmic repoman removing source list](/images/managing-apps/IURA_24_12.png)
105+
![Remove button in Repoman (24.04)](/images/managing-apps/repoman-remove-button-2404.png)
94106

95107
### Updating Installed Applications
96108

@@ -100,17 +112,43 @@ The COSMIC Store can update any applications installed from the software reposit
100112
2. Click `Updates` on the sidebar.
101113
3. Select `Update all` in the top-right corner.
102114

103-
![cosmic store update](/images/managing-apps/IURA_24_20.png)
115+
![Updates page & button in the COSMIC Store](/images/managing-apps/cosmic-store-updates.png)
104116

105117
## Using the Terminal
106118

107-
### Installing Applications
119+
### Searching for Applications
108120

109-
Launch the Terminal (`SUPER` + `T`) to install applications using a command line interface. The command to use depends on which package manager you're using for an app.
121+
You can discover the package names for new applications using the respective websites for [Flathub](https://flathub.org/) and [the Ubuntu repositories](https://packages.ubuntu.com/), or you can search for applications with a command line interface. Launch the Terminal (`SUPER` + `T`), then use the commands below.
122+
123+
#### Flatpaks
124+
125+
Search with the following command:
126+
127+
```
128+
flatpak search [search term]
129+
```
130+
131+
The package name for each search result is displayed in the `Application ID` column.
110132

111-
### Flatpaks
133+
![Flatpak search results](/images/managing-apps/search-flatpak.jpg)
112134

113-
**Flatpaks** are a modern type of package that utilize containerization and sandboxing for increased stability and security. Installing a Flatpak also installs all of its dependencies and libraries, and different Flatpak applications can use different versions of their dependencies at the same time if necessary. [Flathub](https://flathub.org/) is the default source for most Flatpak applications in Pop!_OS.
135+
#### .deb (System) Packages
136+
137+
Search with the following command:
138+
139+
```
140+
apt search [search term]
141+
```
142+
143+
The package name for each search result is displayed in green, before the `/` character.
144+
145+
![apt search results](/images/managing-apps/search-apt.jpg)
146+
147+
### Installing and Removing Applications
148+
149+
Launch the Terminal (`SUPER` + `T`) to install applications using a command line interface. The command to use depends on which package manager you're using for an app.
150+
151+
#### Flatpaks
114152

115153
To install an application as a Flatpak:
116154

@@ -126,9 +164,7 @@ To uninstall an application as a Flatpak:
126164
flatpak uninstall [packagename]
127165
```
128166

129-
### .deb Files
130-
131-
**.deb files** (short for Debian files) are an older packaging format that forms the base of the operating system. They're installed by the `dpkg` or `apt` utilities (with `apt` also handling dependency resolution). Only one version of a dependency can usually be installed at a time with .deb files. [The Ubuntu repositories](https://packages.ubuntu.com/) are the primary source of non-default .deb packages available to install in Pop!_OS and Ubuntu. (System packages installed by default are sometimes sourced from the first-party Pop!_OS repositories instead.)
167+
#### .deb Packages
132168

133169
To install an application with apt:
134170

@@ -158,11 +194,11 @@ sudo apt autoremove --purge
158194

159195
2. After each command, if prompted, answer `Y` and enter your password.
160196

161-
![yes](/images/managing-apps/IURA_22_24.png)
197+
![Bad screenshot that needs to be replaced](/images/managing-apps/terminal-dist-upgrade-bad.png)
162198

163199
3. If an error appears, read the error message and run any commands it suggests.
164200

165-
![error](/images/managing-apps/IURA_22_25.png)
201+
![Bad screenshot taht needs to be replaced](/images/managing-apps/terminal-error-bad.png)
166202

167203
#### Updating Flatpaks
168204

@@ -181,15 +217,15 @@ Pop!_OS 22.04 and below include the Pop!_Shop, which looks different from the CO
181217

182218
1. Open the Pop! Shop by clicking the rocket ship icon in the dock, or press SUPER and search for “pop shop”.
183219

184-
![pop shop](/images/managing-apps/IURA_22_1.png)
220+
![Pop!_Shop icon in the dock](/images/managing-apps/pop-shop-icon.png)
185221

186222
2. Explore apps in categories, or type the application name in the search field.
187223

188-
![pop shop search](/images/managing-apps/IURA_22_2.png)
224+
![Pop!_Shop search bar](/images/managing-apps/pop-shop-search.png)
189225

190-
3. Select the .deb or flatpak version.
226+
3. Select the Pop!_OS/Ubuntu (.deb) or flathub (Flatpak) version.
191227

192-
![pop shop select app version](/images/managing-apps/IURA_22_3.png)
228+
![Selecting the app type in the Pop!_Shop](/images/managing-apps/pop-shop-select-type.png)
193229

194230
4. Click **Install**.
195231

@@ -199,23 +235,23 @@ The Pop!_Shop lists applications available in the configurated software reposito
199235

200236
1. Search for the application download link and instructions online.
201237

202-
![pop browser app search](/images/managing-apps/IURA_22_4.png)
238+
![Pop!_OS 22.04 browser search](/images/managing-apps/browser-search-2204.png)
203239

204240
2. Download the application. When given multiple options of file type, look for a 64-bit .deb or Debian/Ubuntu option.
205241

206-
![pop download .deb app ](/images/managing-apps/IURA_22_5.png)
242+
![Selecting the .deb type on the download webpage](/images/managing-apps/browser-select-type.png)
207243

208244
3. After downloading, go to the Downloads folder and double-click the .deb file.
209245

210-
![pop downloaded .deb file](/images/managing-apps/IURA_22_6.png)
246+
![Downloaded .deb file in Pop!_OS 22.04](/images/managing-apps/downloaded-deb-file-2204.png)
211247

212248
4. Open the file in Eddy, the default hanlder for .deb files in older versions of Pop!_OS.
213249

214-
![pop downloaded .deb file](/images/managing-apps/IURA_22_7.png)
250+
![Opening a .deb file with Eddy in Pop!_OS 22.04](/images/managing-apps/eddy-open-with.png)
215251

216252
5. Click Install, then enter your password if prompted.
217253

218-
![pop eddy](/images/managing-apps/IURA_22_8.png)
254+
![Installing a package with Eddy in Pop!_OS 22.04](/images/managing-apps/eddy-install.png)
219255

220256
### Managing Repositories
221257

@@ -225,31 +261,31 @@ You can add, remove, and edit software repositories using Repoman. This includes
225261

226262
1. Access Repoman by launching the Pop!_Shop, then clicking the `System Software Sources` option in the top-right menu or pressing the `Ctrl` + `S` keyboard shortcut in the Pop!_Shop.
227263

228-
![pop system software sources option](/images/managing-apps/IURA_22_9.png)
264+
![Pop!_Shop System Software Sources menu item](/images/managing-apps/pop-shop-sources.png)
229265

230266
2. Click on the Extra Sources tab to manage .deb repositories (PPAs), or the Flatpak tab to manage Flatpak repositories.
231267

232-
![pop repoman extrasource](/images/managing-apps/IURA_22_10.png)
268+
![Repoman's Extra Sources page in Pop!_OS 22.04](/images/managing-apps/repoman-extra-sources-2204.png)
233269

234270
#### Adding a Repository
235271

236272
1. Click the `+` button in the bottom-left corner.
237273

238-
![pop repoman extra source tab](/images/managing-apps/IURA_22_11.png)
274+
![Add button in Repoman (22.04)](/images/managing-apps/repoman-add-button-2204.png)
239275

240276
2. Enter the source details for the repository and click Add.
241277

242-
![pop repoman add source](/images/managing-apps/IURA_22_12.png)
278+
![Adding a source in Repoman (22.04)](/images/managing-apps/repoman-adding-2204.png)
243279

244280
3. The repository will appear in the sources list.
245281

246-
![pop repoman added source](/images/managing-apps/IURA_22_13.png)
282+
![Added source in Repoman (22.04)](/images/managing-apps/repoman-added-2204.png)
247283

248284
#### Removing a Repository
249285

250286
Select a repository from the list, then click on the trashcan icon to delete the repository.
251287

252-
![pop repoman remove source](/images/managing-apps/IURA_22_14.png)
288+
![Remove button in Repoman (22.04)](/images/managing-apps/repoman-remove-button-2204.png)
253289

254290
### Updating Installed Applications
255291

@@ -259,8 +295,8 @@ The Pop!_Shop can update any applications installed from the software repositori
259295

260296
2. Click `Updates & Installed Software` in the top-right menu, or press the `Ctrl` + `I` keyboard shortcut in the Pop!_Shop.
261297

262-
![pop shop updates & installed software](/images/managing-apps/IURA_22_22.png)
298+
![Pop!_Shop Updates & Installed Software menu button](/images/managing-apps/pop-shop-updates-menu.png)
263299

264-
3. Select **Update All**.
300+
3. Select `Update All`.
265301

266-
![pop updates](/images/managing-apps/IURA_22_23.png)
302+
![Updates page & button in the Pop!_Shop](/images/managing-apps/pop-shop-updates-page.png)

0 commit comments

Comments
 (0)