Skip to main content
Terra provides repositories for both Fedora and Enterprise Linux 10. Choose your installation method based on your operating system.
For the most up-to-date installation instructions, visit our developer documentation.

​
Fedora installation

1

Install the base repository

Choose the installation method based on your Fedora edition.

​
Standard Fedora

Run this command to install the Terra repository:
sudo dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terra$releasever' terra-release

​
Immutable/Atomic editions

If you’re using Fedora Silverblue, Kinoite, or other atomic editions, use these commands instead:
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
On atomic editions, you’ll need to reboot after installing terra-release for changes to take effect.
2

Install optional subrepos (optional)

Terra provides specialized subrepos for different use cases. Install the ones you need:
The Extras subrepo contains packages that conflict with Fedora packages in some way, such as patched versions of the same package.
sudo dnf install terra-release-extras
Extra care and caution may be needed as some of these packages may conflict with other repositories such as RPM Fusion.
Install a patched and codec-complete Mesa for enhanced multimedia support.
sudo dnf install terra-release-mesa
This will replace your system’s Mesa installation with Terra’s patched version.
Get NVIDIA drivers directly from Terra.
sudo dnf install terra-release-nvidia
Access multimedia packages in Terra. This repository is currently considered a work in progress.
sudo dnf install terra-release-multimedia
This subrepo is still under development and may have stability issues.
3

Update your system

After installing Terra, update your package cache:
sudo dnf update

​
Enterprise Linux installation

Only EL10 is supported. Not all packages available in Terra are available in Terra EL at this time.
1

Install EPEL repositories

Terra EL requires the EPEL (Extra Packages for Enterprise Linux) repositories:
sudo dnf install 'https://dl.fedoraproject.org/pub/epel/epel-release-latest-$releasever.noarch.rpm'
This command will automatically detect your EL version and install the appropriate EPEL release.
2

Install Terra EL

Install the Terra repository for Enterprise Linux:
sudo dnf install --nogpgcheck --repofrompath 'terra,https://repos.fyralabs.com/terrael$releasever' terra-release
3

Update your system

Refresh your package cache:
sudo dnf update

​
Repository configuration

Terra uses a metalink-based repository configuration for optimal performance and reliability. The main repository configuration looks like this:
terra.repo
[terra]
name=Terra $releasever
metalink=https://tetsudou.fyralabs.com/metalink?repo=terra$releasever&arch=$basearch
metadata_expire=6h
type=rpm
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-terra$releasever
repo_gpgcheck=1
enabled=1
enabled_metadata=1
countme=1
  • metalink: Uses Tetsudou (Fyra Labs’ mirror manager) to select the best mirror for you
  • metadata_expire: Repository metadata is refreshed every 6 hours
  • gpgcheck: All packages are cryptographically verified for security
  • repo_gpgcheck: Repository metadata is also verified
  • countme: Anonymous usage statistics to help prioritize mirror resources

​
Verify installation

Confirm that Terra is properly installed: 
dnf repolist | grep terra
You should see terra in the list of enabled repositories. If you installed subrepos, you’ll also see terra-extras, terra-mesa, terra-nvidia, or terra-multimedia.

​
What’s next?

Quick start guide

Learn how to install and use packages from Terra

Browse packages

Search for available packages

​
Troubleshooting

If you encounter GPG errors, the repository GPG keys may not be properly installed. Try reinstalling terra-release:
sudo dnf reinstall terra-release
Some packages in Terra (especially in the Extras subrepo) may conflict with RPM Fusion packages. You may need to adjust repository priorities or exclude specific packages.To set a lower priority for Terra Extras:
sudo dnf config-manager --setopt=terra-extras.priority=150 --save
On Fedora Silverblue, Kinoite, and other atomic editions, remember to reboot after installing or updating packages:
sudo systemctl reboot
Need help? Join our community chat for support.

Build docs developers (and LLMs) love

Get started for freeTalk to us