Installing
This page goes over how to install Terra for various distributions.
Fedora and Derivatives
Section titled “Fedora and Derivatives”Directly install terra-release:
Note The below command uses --nogpgcheck because it must fetch the package repo from the origin server. Once the keys are installed all further packages installed from Terra will be verified against the key. If preferable, you can download and inspect the RPMs yourself first.
sudo dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terra$releasever' terra-release terra-gpg-keysUltramarine Linux
Section titled “Ultramarine Linux”Ultramarine already comes with Terra out of the box, simply dnf away!
Nobara
Section titled “Nobara”Nobara already comes with Terra out of the box, simply use one of their graphical apps or dnf away!
Fedora Atomic and Derivatives
Section titled “Fedora Atomic and Derivatives”On Atomic editions of Fedora, run the following command:
curl -fsSL https://raw.githubusercontent.com/terrapkg/packages/f$(rpm --eval '%{fedora}')/anda/terra/release/terra.repo | pkexec tee /etc/yum.repos.d/terra.reporpm-ostree install terra-release terra-gpg-keysBazzite
Section titled “Bazzite”Bazzite comes with Terra, but disables it.
Edit /etc/yum.repos.d/terra.repo and change enabled=0 to enabled=1
Do this again for /etc/yum.repos.d/terra-extras.repo
Then you can simply rpm-ostree away!
SecureBlue
Section titled “SecureBlue”Follow the installation instructions for Fedora Atomic, but replace pkexec in the curl script with run0.
Enterprise Linux
Section titled “Enterprise Linux”Terra EL contains a subset of packages for RHEL 10 and its derivatives.
Terra EL requires EPEL, which requires CodeReady Builder, let’s start by enabling that:
sudo subscription-manager repos --enable codeready-builder-for-rhel-10-$(arch)-rpmsThen install EPEL:
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpmNow you can install Terra!
sudo dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terrael$releasever' terra-release terra-gpg-keysAlmaLinux, CentOS Stream, and RockyLinux
Section titled “AlmaLinux, CentOS Stream, and RockyLinux”Start by enabling CodeReady Builder:
sudo dnf config-manager --set-enabled crbThen install epel-release
sudo dnf install epel-releaseNow you can install Terra!
sudo dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terrael$releasever' terra-release terra-gpg-keysSubrepos
Section titled “Subrepos”Terra provides additional packages in separate repositories. These packages might conflict with RPM Fusion or the Fedora repositories. Extra care and technical knowledge may be needed.
The current list of subrepos are extras, nvidia, mesa, multimedia (f43+ only).
They can be enabled by installing terra-release-extras, terra-release-nvidia, etc.
Extras
Section titled “Extras”The extras subrepo provides miscellaneous packages that conflict with Fedora. Things like patched WINE and Switcheroo control are in Extras.
Run the following to enable terra-extras:
sudo dnf install terra-release-extrasThe Mesa subrepo provides our build of Mesa, with patches from the Open Gaming Collective and most features enabled, unlike RPMFusion and Fedora’s builds.
Run the following to enable terra-mesa:
sudo dnf install terra-release-mesaIf you have any Mesa -freeworld packages from RPM Fusion installed, you should remove them before installing our Mesa.
NVIDIA
Section titled “NVIDIA”The NVIDIA subrepo provides a selection of drivers and software for NVIDIA GPUs. We offer drivers based on Negativo17’s builds, and CUDA packages.
Run the following to enable terra-nvidia:
sudo dnf install terra-release-nvidiaMultimedia
Section titled “Multimedia”The multimedia subrepo is only available on Fedora 43 and newer. It provides multimedia codecs and related software, like gstreamer1 packages and ffmpeg.
Run the following to enable terra-multimedia:
sudo dnf install terra-release-multimediaUsing Terra
Section titled “Using Terra”Install
Section titled “Install”sudo dnf install package-name another-packageSearch
Section titled “Search”dnf search package-name(or)dnf provides package-nameRemove
Section titled “Remove”sudo dnf remove package-name another-packageUpgrade
Section titled “Upgrade”sudo dnf upgrade(or)sudo dnf upgrade package-name another-package