Git-Mirrors/qubes-doc
1
0
Fork 0
mirror of https://github.com/QubesOS/qubes-doc.git synced 2024-12-25 15:29:29 -05:00
Code Issues Packages Projects Releases Wiki Activity

Improve formatting and style consistency; add reminder; fix typo

Browse Source
This commit is contained in:
Andrew David Wong 2022-04-20 14:37:28 -07:00
parent ca5b730194
commit 33b73af4ae
No known key found for this signature in database
GPG Key ID: 8CE137352A019A17
1 changed files with 27 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

53
user/how-to-guides/how-to-install-software.md
View File

@ -54,15 +54,14 @@ repositories first.)
- Fedora: `sudo dnf install <PACKAGE_NAME>` - Fedora: `sudo dnf install <PACKAGE_NAME>`
- Debian: `sudo apt install <PACKAGE_NAME>` - Debian: `sudo apt install <PACKAGE_NAME>`
4. **Shut down the template. (Do not skip this step.)** 4. Shut down the template.
5. **Restart all qubes based on the template. (Do not skip this step.)** 5. Restart all qubes based on the template.
6. (Recommended) In the relevant qubes' **Qube Settings**, go to the 6. (Recommended) In the relevant qubes' **Settings > Applications** tab, select
**Applications** tab, select the new application(s) from the list, and press the new application(s) from the list, and press **OK**. These new shortcuts
OK. These new shortcuts will appear in the Applications Menu. (If you will appear in the Applications Menu. (If you encounter problems, see
encounter problems, see [here](/doc/app-menu-shortcut-troubleshooting/) for [here](/doc/app-menu-shortcut-troubleshooting/) for troubleshooting.)
troubleshooting.)
![[The Applications tab in Qube Settings](/attachment/doc/r4.1-dom0-appmenu-select.png)](/attachment/doc/r4.1-dom0-appmenu-select.png) ![[The Applications tab in Qube Settings](/attachment/doc/r4.1-dom0-appmenu-select.png)](/attachment/doc/r4.1-dom0-appmenu-select.png)
@ -82,17 +81,18 @@ Qubes OS.
1. (Recommended) Clone the desired template (since this new template will 1. (Recommended) Clone the desired template (since this new template will
probably be less trusted than the original). probably be less trusted than the original).
2. (Recommended) In the new template's Basic settings, change the color label 2. (Recommended) In the new template's **Settings > Basic** tab, change the
from black to red (or another color that signifies to you that the template color label from black to red (or another color that signifies to you that
is less trusted). the template is less trusted).
3. In the new template's Basic settings, change the Networking value from 3. In the new template's **Settings > Basic** tab, change the **Networking**
`default (none) (current)` to `sys-firewall` (or whichever network-providing value from `default (none) (current)` to `sys-firewall` (or whichever
qube you wish to use). network-providing qube you wish to use).
4. (Recommended) In the new template's Firewall rules tab, select "Limit 4. (Recommended) In the new template's **Settings > Firewall rules** tab,
outgoing Internet connections to...." and tick "Allow full access for 5 select "Limit outgoing Internet connections to..." and tick "Allow full
min." (This can help in case you forget to remove network access later.) access for 5 min." (This can help in case you forget to remove network
access later.)
5. Follow the normal instructions for installing your software in the new 5. Follow the normal instructions for installing your software in the new
template. For example, open a terminal and enter the commands as instructed. template. For example, open a terminal and enter the commands as instructed.
@ -100,19 +100,19 @@ Qubes OS.
then this can be extremely risky, and the template should be regarded as then this can be extremely risky, and the template should be regarded as
*completely untrusted*. *completely untrusted*.
6. (Recommended) In the new template's Basic settings, change the Networking 6. (Recommended) In the new template's **Settings > Basic** tab, change the
value from `sys-firewall (current)` (or whichever network-providing qube you **Networking** value from `sys-firewall (current)` (or whichever
chose) back to `default (none)`. network-providing qube you chose) back to `default (none)`.
7. **Shut down the template. (Do not skip this step.)** 7. Shut down the new template.
8. **Restart all qubes based on the template. (Do not skip this step.)** 8. Create or assign your desired app qubes to use the new template. If any app
qubes were already assigned to the new template, restart them.
9. (Recommended) In the relevant qubes' **Qube Settings**, go to the 9. (Recommended) In the relevant qubes' **Settings > Applications** tab, select
**Applications** tab, select the new application(s) from the list, and press the new application(s) from the list, and press **OK**. These new shortcuts
OK. These new shortcuts will appear in the Applications Menu. (If you will appear in the Applications Menu. (If you encounter problems, see
encounter problems, see [here](/doc/app-menu-shortcut-troubleshooting/) for [here](/doc/app-menu-shortcut-troubleshooting/) for troubleshooting.)
troubleshooting.)
![[The Applications tab in Qube Settings](/attachment/doc/r4.1-dom0-appmenu-select.png)](/attachment/doc/r4.1-dom0-appmenu-select.png) ![[The Applications tab in Qube Settings](/attachment/doc/r4.1-dom0-appmenu-select.png)](/attachment/doc/r4.1-dom0-appmenu-select.png)
@ -124,6 +124,7 @@ If things are still not working as expected:
- Review the instructions very carefully, making sure you follow each step. - Review the instructions very carefully, making sure you follow each step.
- Make sure you **shut down the template after installing your software**. - Make sure you **shut down the template after installing your software**.
- Make sure you **restart your app qube *after* shutting down your template**. - Make sure you **restart your app qube *after* shutting down your template**.
- Make sure your app qube is assigned to the right template.
- If your software requires special files or directories to be persistent, and - If your software requires special files or directories to be persistent, and
you're an advanced user, see [standalones and you're an advanced user, see [standalones and
HVMs](/doc/standalones-and-hvms/) and [how to make any file persistent HVMs](/doc/standalones-and-hvms/) and [how to make any file persistent