Skip to main content
This guide will help you start using Terra packages right away. If you haven’t installed Terra yet, visit the installation guide first.

​
Install your first package

Once Terra is set up, installing packages is straightforward: 
sudo dnf install <package-name>
Here are some popular packages you can install from Terra right away:
Install the latest Discord client:
sudo dnf install discord
Terra also offers alternative Discord builds:
  • discord-openasar - Discord with OpenAsar for improved performance
  • discord-canary - Discord Canary (beta) builds
  • discord-ptb - Discord Public Test Build
Get VS Codium (VSCode without Microsoft telemetry):
sudo dnf install codium
For marketplace support:
sudo dnf install codium-marketplace
Install Anki for spaced repetition learning:
sudo dnf install anki
Alternative builds available:
  • anki-bin - Official binary build
  • anki-qt5 - Qt5 version for older systems
Install Bun, the fast all-in-one JavaScript runtime:
sudo dnf install bun

​
Search for packages

You can search for available packages in several ways:
1

Search using dnf

Use the built-in package search:
dnf search <keyword>
For example, to find game-related packages:
dnf search game
2

Browse online

Visit package databases to see what’s available:These sites provide detailed package information, dependencies, and version tracking.
3

List all packages

See all packages available in Terra:
dnf repository-packages terra list available
To see packages from a specific subrepo:
dnf repository-packages terra-extras list available

​
Explore package categories

Terra organizes packages into several categories:

Applications

Example packages:
  • discord - Communication platform
  • bitwarden - Password manager (CLI)
  • flameshot - Screenshot tool
  • audacity-freeworld - Audio editor with extra codecs

Games

Example packages:
  • gamescope-session - Gaming session manager
  • emulationstation-de - Emulator frontend
  • 8bitdo-udev-rules - Controller support
  • chess-tui - Terminal chess game

Development

Example packages:
  • android-studio - Android development IDE
  • bun - JavaScript runtime
  • codium - Code editor
  • asdf - Version manager

System

Example packages:
  • nvidia drivers (via nvidia subrepo)
  • mesa patched builds (via mesa subrepo)
  • NVIDIA and system utilities

​
Using subrepo packages

If you’ve installed optional subrepos, here’s how to use them:

​
Extras subrepo

The Extras subrepo contains patched or alternative versions of packages: 
# First install the subrepo
sudo dnf install terra-release-extras

# Then install packages from it
sudo dnf install audacity-freeworld
Some Extras packages may conflict with Fedora or RPM Fusion packages. Review package descriptions carefully.

​
NVIDIA subrepo

For NVIDIA graphics drivers: 
# Install the NVIDIA subrepo
sudo dnf install terra-release-nvidia

# Install NVIDIA drivers
sudo dnf install nvidia-driver

​
Mesa subrepo

For codec-complete Mesa: 
# Install the Mesa subrepo
sudo dnf install terra-release-mesa

# Update to Terra's Mesa
sudo dnf distro-sync
The Mesa subrepo will replace your system’s Mesa packages with Terra’s patched versions.

​
Keep Terra updated

Terra is a rolling-release repository, so you’ll get updates as they’re released: 
sudo dnf upgrade
To update only Terra packages: 
sudo dnf repository-packages terra upgrade

​
Package information

Get detailed information about any package: 
dnf info <package-name>
See what a package provides: 
dnf repoquery --provides <package-name>
Check package dependencies: 
dnf repoquery --requires <package-name>

​
Remove packages

If you need to remove a Terra package: 
sudo dnf remove <package-name>

​
Common workflows

Install essential development tools from Terra:
# Install modern developer tools
sudo dnf install bun codium android-studio

# Add version managers
sudo dnf install asdf
Get gaming tools and utilities:
# Install gaming session and tools
sudo dnf install gamescope-session emulationstation-de

# Add controller support
sudo dnf install 8bitdo-udev-rules
Install codec-complete applications:
# Install the multimedia subrepo
sudo dnf install terra-release-multimedia

# Get codec-enhanced applications
sudo dnf install audacity-freeworld

​
What’s next?

Browse all packages

Explore the complete Terra package catalog

Contribute packages

Learn how to add packages to Terra

Read the FAQ

Get answers to common questions

Join the community

Connect with other Terra users

​
Need help?

If you run into issues or have questions:
  1. Check the FAQ for common solutions
  2. Join our community chat for support
  3. Review the full developer documentation
Terra is community-driven. We welcome your feedback and contributions!

Build docs developers (and LLMs) love

Get started for freeTalk to us