New PR for Managing Apps Article #1349
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,346 @@ | ||
| --- | ||
| 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 Terminal | ||
|
|
||
| Launch the Terminal `SUPER` + `T` to Install applications using a command line interface. Terminal commands instruct package managers to retrieve application installation packages from repositories. | ||
|
|
||
| ### Flatpaks & .Deb Files | ||
|
|
||
| **Flatpaks** will install a “containerized” version of the software. This means the software runs in its own sandbox, and the installation will include all dependencies and libraries required by the application. Flatpaks pull all dependencies from flathub.org, while installing with apt will pull from Ubuntu repos. | ||
|
Member
There was a problem hiding this comment.
The word "will" is unnecessary here.
These are broad generalizations that aren't correct for all packages and aren't even correct for the default packages since Pop!_OS has its own apt repos. Please qualify the statements about the default repos. |
||
|
|
||
| Substitute `[packagename]` with the desired application (do not include brackets in the command). | ||
|
Member
There was a problem hiding this comment. The package name is often not just the human-readable name for the app. You might want to explain how to use https://packages.ubuntu.com/ and/or |
||
|
|
||
| Apt install: | ||
|
|
||
| ```bash | ||
| apt install [packagename] | ||
|
Member
There was a problem hiding this comment. This would need |
||
| ``` | ||
|
|
||
| Apt uninstall: | ||
|
|
||
| ```bash | ||
| sudo apt remove [packagename] | ||
|
Member
There was a problem hiding this comment. I'd recommend making this |
||
| ``` | ||
|
|
||
| Apt uninstall (alternative): | ||
|
Member
There was a problem hiding this comment. "alternative" says nothing about what this command does or why you'd use it rather than the previous removal command. The difference between |
||
|
|
||
| ```bash | ||
| sudo apt purge [packagename] | ||
| ``` | ||
|
|
||
| Flatpak install: | ||
|
|
||
| ```bash | ||
| flatpak install [packagename] | ||
| ``` | ||
|
|
||
| Flatpak uninstallL | ||
|
|
||
| ```bash | ||
| flatpak uninstall [packagename] | ||
| ``` | ||
|
|
||
| ## Updating POP!\_OS via Terminal | ||
|
Member
There was a problem hiding this comment. I'd suggest saying "the Terminal" instead of just "Terminal" in these headings. Pop!_OS should not be in all caps. |
||
|
|
||
| 1. Open a terminal by pressing `SUPER` + `T` and type the following commands: | ||
|
|
||
| ```bash | ||
| sudo apt update | ||
| ``` | ||
|
|
||
| ```bash | ||
| sudo apt dist-upgrade | ||
|
Member
There was a problem hiding this comment.
If you're not going to include any info in between these two commands, then they should be in the same code block instead of separate code blocks. |
||
| ``` | ||
|
|
||
| 2. Answer `Y` and enter the password when prompted. | ||
|
|
||
|  | ||
|
Member
There was a problem hiding this comment. 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. | ||
|
Member
There was a problem hiding this comment. This is a great idea to mention. Lots of users seem to not think to run what's suggested. |
||
|
|
||
|  | ||
|
Member
There was a problem hiding this comment. 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 open source applications. | ||
|
Member
There was a problem hiding this comment. COSMIC should be in all caps. Whether or not apps are open-source is unrelated to the COSMIC Store-- there are plenty of proprietary apps on Flathub and even a few in the Pop!_OS repositories. Please remove the "open source" qualifier. |
||
|
|
||
| 1. Open Cosmic Store by clicking the icon in the dock, or press `SUPER` and type “Cosmic Store”. | ||
|
Member
There was a problem hiding this comment. I'd say "the COSMIC Store" instead of just "COSMIC Store" (and again, COSMIC should be in all caps). With the way this sentence is written, "press" and "type" should be "pressing" and "typing", respectively. I'd say "or pressing |
||
|
|
||
|  | ||
|
Member
There was a problem hiding this comment. 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. | ||
|
Member
There was a problem hiding this comment. Why would someone select one or the other? If you're going to mention this setting, then you should explain it. |
||
|
|
||
|  | ||
|
|
||
| ### Installing an Application Not Included in the Cosmic Store | ||
|
Member
There was a problem hiding this comment. 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. 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. | ||
|
Member
There was a problem hiding this comment. double-click should be hyphenated. |
||
|
|
||
|  | ||
|
|
||
| 4. Cosmic Store will open automatically and present you with the option to install the file. | ||
|
Member
There was a problem hiding this comment. The word "automatically" is superfluous and arguably wrong (you double-clicked on the file manually to make it open). It's probably best to remove that word. |
||
|
|
||
|  | ||
|
|
||
| ### 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. 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. | ||
|
Member
There was a problem hiding this comment. Linux would need to be capitalized here. |
||
|
|
||
| 1. Press `SUPER` and search for “Repoman" | ||
|
Member
There was a problem hiding this comment. This line needs punctuation at the end. |
||
|
|
||
|  | ||
|
|
||
| 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. 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. 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 and then click on the trashcan icon to delete the repository. | ||
|
Member
There was a problem hiding this comment. "and then" with no punctuation makes this sentence read a little long. Try replacing "and" with a comma. |
||
|
|
||
|  | ||
|
|
||
| ### Launching Applications | ||
|
|
||
| Find and start installed applications using these four methods. | ||
|
Member
There was a problem hiding this comment. 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. | ||
|
Member
There was a problem hiding this comment. "The" shouldn't be capitalized as the second word in the sentence. |
||
|
|
||
|  | ||
|
|
||
| View installed applications with Show Applications. Display installed applications by clicking Show Applications in the dock. | ||
|
Member
There was a problem hiding this comment. It's not Show Applications, it's just labeled Applications. You can also refer to it as the application library (or app library). |
||
|
|
||
|  | ||
|
|
||
|  | ||
|
|
||
| Find applications by clicking Applications in the upper left corner of the home screen. | ||
|
|
||
|  | ||
|
Member
There was a problem hiding this comment. 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`. | ||
|
Member
There was a problem hiding this comment. Since this is formatted as code, it should reflect the label's actual case. That means it should say |
||
|
|
||
|  | ||
|
|
||
| #### Updating via Terminal | ||
|
Member
There was a problem hiding this comment. 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.
Please put the keyboard shortcut inside of parenthesis since you're not separating it out any other way grammatically.
Also, please de-capitalize the word "install" since it's in the middle of the sentence and has no reason to be capitalized.
This seems like unnecessarily complex wording.