-
-
Notifications
You must be signed in to change notification settings - Fork 28
Improve software-installation section under FAQ #291
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: live
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 |
|---|---|---|
|
|
@@ -203,13 +203,40 @@ | |
|
|
||
| ### [How do I install software?](#software) | ||
| {: #software} | ||
| #### Check if software is already installed | ||
| > `rpm -qa | grep x` | ||
|
|
||
| 1. Check if it's already installed using `rpm -qa | grep x` | ||
| 2. For GUI packages, you can install the Flatpak if available using the Software store or using `flatpak install`. You can browse this [catalogue of Flatpaks](https://flathub.org) to discover the available packages. | ||
| 3. For CLI packages, you can install from brew if available using `brew install`. You can browse this [catalogue of Homebrew Formulae](https://formulae.brew.sh) to discover the available formulae. | ||
| 4. If a package isn't available via the other two options, or if a package requires greater system integration, `rpm-ostree install` can be used to layer rpms directly into your subsequent deployments. | ||
| #### Flatpak | ||
| [Flatpaks](https://flatpak.org/) are the recommended way to install GUI software in secureblue, with the exception of [browsers](https://github.com/RKNF404/chromium-hardening-guide/blob/main/pages/BROWSER_SELECTION.md#flatpak-linux). | ||
| We have a specific article on flatpaks [here](https://secureblue.dev/articles/flatpak) | ||
| There are a few recommended ujust scripts to run for flatpaks, those being: | ||
| > `ujust harden-flatpak` - Enables [Hardened-Malloc](https://github.com/GrapheneOS/hardened_malloc) for flatpaks | ||
|
Contributor
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 remove this, this is run automatically |
||
| > `ujust flatpak-permissions-lockdown` - Significantly reduces default permissions of flatpaks. | ||
|
Contributor
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 remove this, this is covered in the flatpak article |
||
|
|
||
| You can add the unfiltered Flathub repo with `ujust enable-flathub-unfiltered`. | ||
|
Contributor
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 should probably be moved to the flatpak article, with an addition to that article covering what verification is |
||
| ##### Installing Flatpaks | ||
| ###### Bazaar | ||
| [Bazaar](https://github.com/kolunmi/bazaar) is the app store that comes preinstalled with secureblue. It is forked for secureblue so we can make a few of our own changes and audit updates for security. | ||
| It by default filters EoL apps and certain apps with known security issues. Do note that the scope of this filter is limited and an app being unfiltered does not mean it is secure. | ||
| Bazaar has a curated tab for software that compliments secureblue. | ||
| ###### Flatpak CLI | ||
| Flatpaks can by installed using the flatpak CLI tool, which is preinstalled with secureblue. Run `flatpak --help` for a list of commands and their usage. You can browse this [catalogue of Flatpaks](https://flathub.org) to discover the available packages. | ||
| #### CLI Package | ||
|
Contributor
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 should just say |
||
| For CLI packages, you can install with [Homebrew](https://docs.brew.sh/Manpage) using `brew install <package>`. You can browse this [catalogue of Homebrew Formulae](https://formulae.brew.sh) to discover the available formulae. | ||
| #### RPM | ||
| If a package isn't available via Flatpak or Homebrew, or if a package requires greater system integration, `rpm-ostree install <package>` can be used to layer rpms directly into your subsequent deployments. | ||
|
Contributor
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 use paragraphs |
||
| Sometimes an additional repository needs to be added to install software. | ||
| In this case, run: | ||
| `mv /path/to/repo /etc/yum.repos.d/reponame` | ||
|
Contributor
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 should just be an example |
||
| `rpm-ostree install <packagename>` | ||
| Beware, you are trusting a third party to not ship malware. Third party copr's are particularly hazardous. | ||
|
Contributor
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. COPR is all caps as it's an acronym
Contributor
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 "beware.." maybe:
Also, the warning should precede the information on how to add third party repos |
||
| #### Distro-specific format (e.g. .deb) | ||
|
Contributor
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. package format* |
||
| secureblue comes with [distrobox](https://distrobox.it/). This means that formats that are specific to some other distro can often be ran via distrobox. | ||
| For example, you can create and ubuntu container with `distrobox assemble` and then when you have entered that container with `distrobox enter ubuntu` you can use .deb packages from within it. | ||
|
Contributor
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 don't think we should be encouraging this... or maybe even documenting it. It's a horrible practice.
This should be removed |
||
| #### AppImage | ||
|
Contributor
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 should be removed and any appimage info kept in the appimage faq entry |
||
| See [here](https://secureblue.dev/faq#appimage). | ||
| Note: Sometimes AppImages can work if you extract them with `/path/to/your/appimage --appimage-extract`, then enter the `squashfs-root` directory created and run whatever binary is in there. | ||
|
|
||
|
|
||
| ### [How do I install my VPN?](#vpn) | ||
| {: #vpn} | ||
|
|
||
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.
Something like
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.
Also needs a
.at the end. Also, please use paragraphs instead of newlines between each sentence