-
Notifications
You must be signed in to change notification settings - Fork 423
New PR for Managing Apps Article #1349
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| 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. | ||
|
|
||
|  | ||
|
|
||
| 3. If an error appears, read the error message and run any commands it suggests. | ||
jacobgkau marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
|  | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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”. | ||
|
|
||
|  | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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. | ||
|
|
||
|  | ||
|
|
||
| 3. Select the system or flathub version. | ||
jacobgkau marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| - 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. | ||
|
|
||
|  | ||
|
|
||
| ### Installing an Application Not Included in the Cosmic Store | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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:
|
||
|
|
||
| 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. | ||
|
|
||
|  | ||
|
|
||
| 2. Download the application. When given file options, choose 64 bit .deb as the file type. | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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). |
||
|
|
||
|  | ||
|
|
||
| 3. After downloading, go to the Downloads folder and double-click the .deb file. | ||
|
|
||
|  | ||
|
|
||
| 4. The COSMIC Store will open and present you with the option to install the file. | ||
|
|
||
|  | ||
|
|
||
| ### 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. | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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 |
||
|
|
||
| **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". | ||
|
|
||
|  | ||
|
|
||
| 2. Click on the Extra Sources tab. There will be options to add repositories with the Plus button. | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Instead of the passive (Or, just remove that sentence since you're about to duplicate it in the next section.) |
||
|
|
||
|  | ||
|
|
||
| ### Adding a Repository | ||
|
|
||
| 1. Click the plus button. | ||
|
|
||
|  | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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. | ||
|
|
||
|  | ||
|
|
||
| 3. The repository will appear in the sources list. | ||
|
|
||
|  | ||
|
|
||
| ### Removing a Repository | ||
|
|
||
| Select a repository from the list, then click on the trashcan icon to delete the repository. | ||
|
|
||
|  | ||
|
|
||
| ### Launching Applications | ||
|
|
||
| Find and start installed applications using these four methods. | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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. | ||
|
|
||
|  | ||
|
|
||
| View installed applications with Show Applications. Display installed applications by clicking Applications in the dock. | ||
|
|
||
|  | ||
|
|
||
|  | ||
|
|
||
| Find applications by clicking Applications in the upper left corner of the home screen. | ||
|
|
||
|  | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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. | ||
|
|
||
|  | ||
|
|
||
| Pin applications to the dock by right clicking and selecting `Pin to App Tray`. | ||
|
|
||
|  | ||
|
|
||
| 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. | ||
|
|
||
|  | ||
|
|
||
| ### 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`. | ||
|
|
||
|  | ||
|
|
||
| #### Updating via Terminal | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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”. | ||
|
|
||
|  | ||
|
|
||
| 2. Explore apps in categories, or type the application name in the search field. | ||
|
|
||
|  | ||
|
|
||
| 3. Select the .deb or flatpak version. | ||
|
|
||
|  | ||
|
|
||
| 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. | ||
|
|
||
|  | ||
|
|
||
| 2. Download the application. When given file options, choose 64 bit .deb as the file type. | ||
|
|
||
|  | ||
|
|
||
| 3. After downloading, go to the Downloads folder and double-click the .deb file. | ||
|
|
||
|  | ||
|
|
||
| 4. Open the file in Pop!_OS’s default handler for .deb files (Eddy). | ||
|
|
||
|  | ||
|
|
||
| 5. Click in Install, enter the user password if prompted. Install using Eddy. | ||
|
|
||
|  | ||
|
|
||
| ### 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`. | ||
|
|
||
|  | ||
|
|
||
| 2. Click on the Extra Sources tab. There will be options to add repositories with the Plus button. | ||
|
|
||
|  | ||
|
|
||
| ### Adding a Repository | ||
|
|
||
| 1. Click the Plus button. | ||
|
|
||
|  | ||
|
|
||
| 2. Enter the source details for the repository and click Add. | ||
|
|
||
|  | ||
|
|
||
| 3. The repository will appear in the sources list. | ||
|
|
||
|  | ||
|
|
||
| ### Removing a repository | ||
|
|
||
| Select a repository from the list and then click on the trashcan icon to delete the repository | ||
|
|
||
|  | ||
|
|
||
| ### 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. | ||
|
|
||
|  | ||
|
|
||
| **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**. | ||
|
|
||
|  | ||
|
|
||
| **View installed applications** with **Show Applications**. Display installed applications by clicking **Show Applications** in the dock. | ||
|
|
||
|  | ||
|
|
||
| Find applications by clicking Applications in the upper left corner of the home screen. | ||
|
|
||
|  | ||
|
|
||
| ### 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. | ||
|
|
||
|  | ||
|
|
||
| Pin applications to the dock by right clicking and selecting **Pin to Dash**. | ||
|
|
||
|  | ||
|
|
||
| Remove applications from the dock by right clicking and choosing Remove from Favorites. | ||
|
|
||
|  | ||
|
|
||
| ### 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. | ||
|
|
||
|  | ||
|
|
||
| 2. Select **Update All**. | ||
|
|
||
|  | ||
There was a problem hiding this comment.
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.