mirror of
https://github.com/QubesOS/qubes-doc.git
synced 2024-12-19 20:54:33 -05:00
83 lines
2.1 KiB
ReStructuredText
83 lines
2.1 KiB
ReStructuredText
===============================
|
||
Installing contributed packages
|
||
===============================
|
||
|
||
|
||
*This page is for users who wish to install contributed packages. If you want to contribute a package, please see* :doc:`package contributions </developer/general/package-contributions>` *.*
|
||
|
||
Qubes OS contributed packages are available under the
|
||
`QubesOS-contrib <https://github.com/QubesOS-contrib/>`__ GitHub
|
||
Project. This is a place where our community can :doc:`contribute Qubes OS related packages, additions and various customizations </developer/general/package-contributions>`.
|
||
|
||
Installing the repositories
|
||
---------------------------
|
||
|
||
|
||
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 <https://github.com/QubesOS-contrib/>`__
|
||
packages.
|
||
|
||
In dom0, use ``qubes-dom0-update``:
|
||
|
||
|
||
|
||
.. code:: bash
|
||
|
||
sudo qubes-dom0-update qubes-repo-contrib
|
||
|
||
|
||
In a Fedora-based template, use ``dnf``:
|
||
|
||
|
||
|
||
.. code:: bash
|
||
|
||
sudo dnf install qubes-repo-contrib
|
||
|
||
|
||
In a Debian-based template, use ``apt``:
|
||
|
||
|
||
|
||
.. code:: bash
|
||
|
||
sudo apt update && sudo apt install qubes-repo-contrib
|
||
|
||
|
||
The new repository definition will be in the usual location for your
|
||
distro, and it will follow the naming pattern ``qubes-contrib-*``,
|
||
depending on your Qubes release and whether it is in dom0 or a template.
|
||
For example, in a Fedora template on Qubes 4.0, the new repository
|
||
definition would be:
|
||
|
||
.. code:: bash
|
||
|
||
/etc/yum.repos.d/qubes-contrib-vm-r4.0.repo
|
||
|
||
|
||
|
||
Installing packages
|
||
-------------------
|
||
|
||
|
||
After you’ve installed the repositories, you can install contributed
|
||
packages.
|
||
|
||
**Note:** The first time you install a contrib package in dom0, you must
|
||
use the ``--clean`` flag.
|
||
|
||
For example, to install ``qvm-screenshot-tool`` in dom0:
|
||
|
||
|
||
|
||
.. code:: bash
|
||
|
||
sudo qubes-dom0-update --clean qvm-screenshot-tool
|
||
|
||
|
||
Please see the package’s README for specific installation and setup
|
||
instructions.
|