Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
348 changes: 348 additions & 0 deletions content/managing-apps.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,348 @@
---
title: Installing, Updating, and Removing Applications
description: >
Quick guide to installing, updating, and removing apps on your device.
keywords:
- Apps
- Install
- Update
- Remove
- Delete

facebookImage: /_social/article
twitterImage: /_social/article

hidden: false
section: pop
tableOfContents: true
---

## Installing & Uninstalling Applications via the Terminal

Launch the Terminal (`SUPER` + `T`) to install applications using a command line interface. Which commands to use depends on which package manager you're using for an app.

### Flatpaks

**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.

To install an application as a Flatpak:

```
flatpak install --app [packagename]
```

Flatpak will ask which app to install if multiple apps match the package name you provided. If you omit the `--app` flag, you'll also see libraries that match the package name.

To uninstall an application as a Flatpak:

```
flatpak uninstall [packagename]
```

### .deb Files

**.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.

To install an application with apt:

```bash
sudo apt install [packagename]
```

To uninstall an application with apt:

```bash
sudo apt autoremove --purge [packagename]
```

The `autoremove` command removes dependencies that are no longer needed in addition to the app itself. The `--purge` flag removes system-wide configuration (such as from the `/etc/` directory) when uninstalling the package. User-specific configuration (in the `/home/` directory) is usually retained when removing packages with apt.

## Updating Pop!\_OS via the Terminal

### Updating System-wide Software (.deb)

1. Open a terminal by pressing `Super` + `T` and type the following commands:

```bash
sudo apt update
sudo apt full-upgrade
sudo apt autoremove --purge
```

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

![yes](/images/managing-apps/IURA_22_24.png)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we get COSMIC Terminal screenshots so they won't look dated as quickly?

Please make the image description a little more detailed, like "Answering yes to apt upgrade prompt". Please also rename the file to something relevant to its content.


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

![error](/images/managing-apps/IURA_22_25.png)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please give this a better filename and description as well.


## Pop!\_OS 24.04

### Installing an Application

COSMIC includes a graphical user interface (GUI) called the COSMIC Store for easy installation and management of applications.

1. Open the COSMIC Store by clicking the icon in the dock, or by pressing `Super` open the launcher and then typing “COSMIC Store”.

![cosmic store icon](/images/managing-apps/IURA_24_1.png)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

COSMIC should be in all caps, even in image descriptions. I'd make this description "COSMIC Store icon in the dock".

Please rename these screenshot files, too.


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

![cosmic store search](/images/managing-apps/IURA_24_2.png)

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

![app download type version](/images/managing-apps/IURA_24_3.png)

### Installing an Application Not Included in the Cosmic Store
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The COSMIC Store doesn't include apps, the default repositories do. The same limitations would apply if someone's using the terminal or another GUI like Synaptic. I'd recommend changing the title to:

Installing an Application Not Included in the Default Repositories


The Cosmic Store does not include all applications available for installation in Pop!_OS. Use the web to search for and install additional applications.

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

![cosmic app google search](/images/managing-apps/IURA_24_4.png)

2. Download the application. When given file options, choose 64 bit .deb as the file type.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You might want to mention that the file type is often referred to as the Ubuntu or Debian version by websites (as illustrated nicely by your example).


![cosmic deb file on download](/images/managing-apps/IURA_22_5.png)

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

![cosmic store icon](/images/managing-apps/IURA_24_5.png)

4. The COSMIC Store will open and present you with the option to install the file.

![cosmic store downloaded file installation](/images/managing-apps/IURA_24_6.png)

### Managing Repositories

Add, remove, and edit repositories using Repoman. Repoman allows users to add Personal Package Archives (PPAs). PPAs are created by developers to distribute software not included in default repositories. Users may want to add a PPA if their software is not included in the Pop!_Shop, or they may want to remove PPA’s after uninstalling a package.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section mentions the Pop!_Shop. Did you copy/paste it from somewhere? Please at least update it to say COSMIC Store instead. Also, I'd say included in the default repositories instead of included in default repositories.


**Caution:** Adding PPA’s allows users to install software that has not been validated by System76 or other trusted Linux repositories. PPA’s may not be vetted against packages that introduce security vulnerabilities. Users should take caution and only add PPA’s that they trust.

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

![cosmic repoman](/images/managing-apps/IURA_24_7.png)

2. Click on the Extra Sources tab. There will be options to add repositories with the Plus button.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of the passive There will be options to add repositories with the Plus button., use a more active (and specific) phrase like Click the Plus button in the bottom left to add a repository.

(Or, just remove that sentence since you're about to duplicate it in the next section.)


![cosmic repoman extra sources](/images/managing-apps/IURA_24_8.png)

### Adding a Repository

1. Click the plus button.

![cosmic repoman add icon](/images/managing-apps/IURA_24_9.png)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd recommend making this image cropped the same as the one above it to help readers remain oriented.


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

![cosmic repoman add source](/images/managing-apps/IURA_24_10.png)

3. The repository will appear in the sources list.

![cosmic repoman source list](/images/managing-apps/IURA_24_11.png)

### Removing a Repository

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

![cosmic repoman removing source list](/images/managing-apps/IURA_24_12.png)

### Launching Applications

Find and start installed applications using these four methods.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This sounds like it should be followed by an ordered list.


Use the Launcher to quickly find and launch installed applications. Pressing the `SUPER` key displays the Launcher. Search for applications by name, then hit `Enter` to launch the application.

![cosmic launch app](/images/managing-apps/IURA_24_13.png)

View installed applications with Show Applications. Display installed applications by clicking Applications in the dock.

![cosmic applications icon](/images/managing-apps/IURA_24_14.png)

![cosmic store apps](/images/managing-apps/IURA_24_15.png)

Find applications by clicking Applications in the upper left corner of the home screen.

![cosmic applications](/images/managing-apps/IURA_24_16.png)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This opens the exact same menu as what you showed above. Maybe just consolidate this screenshot with the one showing the dock icon.


### Add Favorite Applications to the Dock

Add frequently used applications to the dock for quicker access. Applications that appear on the dock can be added or removed as favorites.

![cosmic dock](/images/managing-apps/IURA_24_17.png)

Pin applications to the dock by right clicking and selecting `Pin to App Tray`.

![cosmic pin to app tray](/images/managing-apps/IURA_24_18.png)

To remove applications from the dock, right-click the app and select `Pin to app Tray`. This will uncheck the option and remove the application from the dock.

![cosmic remove icon to tray](/images/managing-apps/IURA_24_19.png)

### Switching Between Running Applications

Use keyboard shortcuts to switch between running applications.

| Shortcut | Action |
| ----------------------------------------------------------------------- | ---------------------------------------- |
| <kbd>SUPER</kbd></kbd> + <kbd>Tab</kbd> | Switch apps |
| <kbd>SUPER</kbd> + <kbd>Tab</kbd> + <kbd>Shift</kbd> | Switch apps in reverse order |

### Updating Installed Applications

Update Pop!_OS and installed applications using the Cosmic Store.

1. Open the Cosmic Store by clicking the icon in the dock. Click `Updates` on the sidebar.

2. Select `Update all`.

![cosmic store update](/images/managing-apps/IURA_24_20.png)

#### Updating via Terminal
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This was already covered earlier. Why is it included twice?


```bash
sudo apt update
```

```bash
sudo apt upgrade
```

## Pop!\_OS 22.04

### Installing an Application

Pop!_OS includes a GUI (Graphical User Interface) called the Pop!_Shop for easy installation and management of open source applications

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

![pop shop](/images/managing-apps/IURA_22_1.png)

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

![pop shop search](/images/managing-apps/IURA_22_2.png)

3. Select the .deb or flatpak version.

![pop shop select app version](/images/managing-apps/IURA_22_3.png)

4. Click **Install**

### Installing an Application Not Included in the Pop!_Shop (GUI)

The Pop!_Shop does not include all applications available for installation in Pop!_OS. Use the web to search for and install additional applications.

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

![pop browser app search](/images/managing-apps/IURA_22_4.png)

2. Download the application. When given file options, choose 64 bit .deb as the file type.

![pop download .deb app ](/images/managing-apps/IURA_22_5.png)

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

![pop downloaded .deb file](/images/managing-apps/IURA_22_6.png)

4. Open the file in Pop!_OS’s default handler for .deb files (Eddy).

![pop downloaded .deb file](/images/managing-apps/IURA_22_7.png)

5. Click in Install, enter the user password if prompted. Install using Eddy.

![pop eddy](/images/managing-apps/IURA_22_8.png)

### Managing Repositories

Add, remove, and edit repositories using Repoman. Repoman allows users to add Personal Package Archives (PPAs). PPAs are created by developers to distribute software not included in default repositories. Users may want to add a PPA if their software is not included in the Pop!_Shop, or they may want to remove PPA’s after uninstalling a package.

**Caution:** Adding PPA’s allows users to install software that has not been validated by System76 or other trusted Linux repositories. PPA’s may not be vetted against packages that introduce security vulnerabilities. Users should take caution and only add PPA’s that they trust.

1. Access Repoman by launching the Pop!_Shop and click the `System Software Sources` or `Ctrl` + `S`.

![pop system software sources option](/images/managing-apps/IURA_22_9.png)

2. Click on the Extra Sources tab. There will be options to add repositories with the Plus button.

![pop repoman extrasource](/images/managing-apps/IURA_22_10.png)

### Adding a Repository

1. Click the Plus button.

![pop repoman extra source tab](/images/managing-apps/IURA_22_11.png)

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

![pop repoman add source](/images/managing-apps/IURA_22_12.png)

3. The repository will appear in the sources list.

![pop repoman added source](/images/managing-apps/IURA_22_13.png)

### Removing a repository

Select a repository from the list and then click on the trashcan icon to delete the repository

![pop repoman remove source](/images/managing-apps/IURA_22_14.png)

### Launching applications

Find and start installed applications using these four methods.

Use the Launcher to quickly find and launch installed applications. Pressing The `SUPER` key displays the Launcher. Search for applications by name, then hit Enter to launch the application.

![pop app launcher](/images/managing-apps/IURA_22_15.png)

**Use a single command to start applications**. Pressing `Alt` + `F2` displays a prompt for running commands. Enter the exact name of the application, then hit **Enter**.

![pop run a command](/images/managing-apps/IURA_22_16.png)

**View installed applications** with **Show Applications**. Display installed applications by clicking **Show Applications** in the dock.

![pop shop view applications](/images/managing-apps/IURA_22_17.png)

Find applications by clicking Applications in the upper left corner of the home screen.

![pop applications](/images/managing-apps/IURA_22_18.png)

### Add Favorite Applications to the dock

Add frequently used applications to the dock for quicker access. Applications that appear on the dock can be added or removed as favorites.

![pop dock](/images/managing-apps/IURA_22_19.png)

Pin applications to the dock by right clicking and selecting **Pin to Dash**.

![pop pin to dash](/images/managing-apps/IURA_22_20.png)

Remove applications from the dock by right clicking and choosing Remove from Favorites.

![pop remove from favorites](/images/managing-apps/IURA_22_21.png)

### Switching Between Running Applications

Use keyboard shortcuts to switch between running applications.

| Shortcut | Action |
| ----------------------------------------------------------------------- | ---------------------------------------- |
| <kbd>SUPER</kbd> + <kbd>Tab</kbd> | Switch apps |
| <kbd>SUPER</kbd> + <kbd>Tab</kbd> + <kbd>Shift</kbd> | Switch apps in reverse order |
| <kbd>SUPER</kbd> + <kbd>`</kbd> | Switch windows of current app |
| <kbd>SUPER</kbd> + <kbd>`</kbd> + <kbd>Shift</kbd> | Switch windows of current app in reverse order |

### Updating Installed Applications

Update Pop!_OS and installed applications using the Pop!_Shop

1. Open the Pop!_Shop by clicking the rocket ship icon in the dock. Click `Updates & Installed Software` in the top middle of the window.

![pop shop updates & installed software](/images/managing-apps/IURA_22_22.png)

2. Select **Update All**.

![pop updates](/images/managing-apps/IURA_22_23.png)
Binary file added static/images/managing-apps/IURA_22_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_10.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_11.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_12.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_13.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_14.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_15.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_16.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_17.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_18.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_19.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_20.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_21.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_22.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_23.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_24.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_25.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_8.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_22_9.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/images/managing-apps/IURA_24_1.png
Binary file added static/images/managing-apps/IURA_24_10.png
Binary file added static/images/managing-apps/IURA_24_11.png
Binary file added static/images/managing-apps/IURA_24_12.png
Binary file added static/images/managing-apps/IURA_24_13.png
Binary file added static/images/managing-apps/IURA_24_14.png
Binary file added static/images/managing-apps/IURA_24_15.png
Binary file added static/images/managing-apps/IURA_24_16.png
Binary file added static/images/managing-apps/IURA_24_17.png
Binary file added static/images/managing-apps/IURA_24_18.png
Binary file added static/images/managing-apps/IURA_24_19.png
Binary file added static/images/managing-apps/IURA_24_2.png
Binary file added static/images/managing-apps/IURA_24_20.png
Binary file added static/images/managing-apps/IURA_24_3.png
Binary file added static/images/managing-apps/IURA_24_4.png
Binary file added static/images/managing-apps/IURA_24_5.png
Binary file added static/images/managing-apps/IURA_24_6.png
Binary file added static/images/managing-apps/IURA_24_7.png
Binary file added static/images/managing-apps/IURA_24_8.png
Binary file added static/images/managing-apps/IURA_24_9.png
Loading