Installing

Currently (June 2025), Terra only supports RPM packages.

Adding Terra

Fedora and Derivatives

Directly install terra-release:

sudo dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terra$releasever' terra-release

There is also a fancy install script:

⚠️

Practice caution before running any commands on your system.

sh <(curl https://terra.fyralabs.com/get.sh)

If you doubt the safety of the script (which you should), curl the script to stdout first:

curl https://terra.fyralabs.com/get.sh

Or, just don't use the fancy script. I guess.

Fedora Atomic and Derivatives

On Atomic editions of Fedora, run the following command:

curl -fsSL https://github.com/terrapkg/subatomic-repos/raw/main/terra.repo | pkexec tee /etc/yum.repos.d/terra.repo
sudo rpm-ostree install terra-release

Bazzite and Aurora

Bazzite and Aurora come with Terra out of the box, simply rpm-ostree away!

Bluefin

Bluefin no longer comes with Terra, and disables package layering by default.

To enable layering, edit /etc/rpm-ostreed.conf and set LockLayering to false.

⚠️

Bluefin doesn't officially support this. If you're getting support, make sure to mention layering is on.

Then follow the installation instructions for Fedora Atomic.

Enterprise Linux

Terra EL contains a subset of packages for RHEL 10 and its derivatives.

RHEL

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

Then install EPEL:

sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm

Now you can install Terra!

sudo dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terrael$releasever' terra-release

AlmaLinux, CentOS Stream, and RockyLinux

Start by enabling CodeReady Builder:

sudo dnf config-manager --set-enabled crb

Then install epel-release

sudo dnf install epel-release

Now you can install Terra!

sudo dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terrael$releasever' terra-release

Using Terra

Install

sudo dnf install package-name another-package

Search

dnf search package-name
(or)
dnf provides package-name

Remove

sudo dnf remove package-name another-package

Upgrade

sudo dnf upgrade
(or)
sudo dnf upgrade package-name another-package

Extra Streams

⚠️

Extra streams are designed to provide additional packages that may conflict with your distribution's default packages i.e Fedora.

If you are not sure what you are doing, it is recommended to not enable the extra streams as it may break your system if not handled properly.

Extra streams are only available for Fedora 41, EL10 and later.

Terra provides extra streams (repositories) for additional packages. To enable them, run:

sudo dnf install terra-release-extras

After installing the extras package, you can then install additional packages that may conflict with Fedora's packages.

Terra contains 2 additional sub-streams included in the extras package:

Mesa Stream

After installing terra-release-extras, you can then enable the Mesa stream:

sudo dnf config-manager setopt terra-mesa.enabled=1

NVIDIA Stream

Terra also provides an additional stream for NVIDIA drivers, based on the Negativo17 (opens in a new tab) builds. To enable the NVIDIA stream, run:

sudo dnf config-manager setopt terra-nvidia.enabled=1

Infrastructure Lifecycle