Add instructions for installing contributed packages

user/advanced-configuration/installing-contributed-packages.md

@@ -0,0 +1,33 @@
+---
+layout: doc
+title: Installing contributed packages
+permalink: /doc/installing-contributed-packages/
+---
+
+# Installing contributed packages
+
+_This page is for users who wish to install contributed packages.
+If you want to contribute a package, please see [package contributions]._
+
+
+Qubes OS contributed packages are available under the [QubesOS-contrib] GitHub Project.
+This is a place where our community can [contribute Qubes OS related packages, additions and various customizations][package contributions].
+
+If you want to install one of these packages, first you need to enable the repository in your system (dom0 and/or templates). This can be done by installing the `qubes-repo-contrib` package. This package includes the repository definition and keys necessary to download, verify, and install [QubesOS-contrib] packages.
+
+In dom0, use `qubes-dom0-update`:
+
+    sudo qubes-dom0-update qubes-repo-contrib
+
+In a Fedora-based template, use `dnf`:
+
+    sudo dnf install qubes-repo-contrib
+
+In a Debian-based template, use `apt`:
+
+    sudo apt update && sudo apt install qubes-repo-contrib
+
+
+[package contributions]: /doc/package-contributions/
+[QubesOS-contrib]: https://github.com/QubesOS-contrib/
+

user/common-tasks/software-update-dom0.md

@@ -122,6 +122,10 @@ sudo qubes-dom0-update --enablerepo=qubes-dom0-unstable
 To enable or disable any of these repos permanently, change the corresponding `enabled` value to `1` in
 `/etc/yum.repos.d/qubes-dom0.repo`.
 
+## Contributed package repository
+
+Please see [installing contributed packages].
+
 ## Kernel upgrade
 
 This section describes upgrading the kernel in dom0 and domUs.
@@ -219,4 +223,5 @@ For example: sys-whonix.
 [testing]: /doc/testing/
 [troubleshooting newer hardware]: /doc/newer-hardware-troubleshooting/
 [Managing VM kernel]: /doc/managing-vm-kernel/
+[installing contributed packages]: /doc/installing-contributed-packages/
 

user/common-tasks/software-update-domu.md

@@ -43,6 +43,9 @@ Advanced users can execute the standard update command for that operating system
 
 If you wish to install updates that are still in [testing], you must enable the appropriate testing repositories.
 
+## Contributed package repository
+
+Please see [installing contributed packages].
 
 ### Fedora
 
@@ -314,4 +317,5 @@ Note that the app will autostart only when the AppVM starts. If you would like t
 [RPM Fusion]: http://rpmfusion.org/
 [service framework]: /doc/qubes-service/
 [How to Reinstall a TemplateVM]: /doc/reinstall-template/
+[installing contributed packages]: /doc/installing-contributed-packages/