qubes-doc/user/advanced-topics/installing-contributed-packages.md

2.0 KiB

lang layout permalink ref title
en doc /doc/installing-contributed-packages/ 225 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.

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 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

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:

/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:

sudo qubes-dom0-update --clean qvm-screenshot-tool

Please see the package's README for specific installation and setup instructions.