mirror of
https://github.com/QubesOS/qubes-doc.git
synced 2024-12-23 22:39:27 -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.
|