Feedback for "Install"

[JdotCarver]

Hi! Quick docs improvement request based on a fresh Bazzite install (GNOME/Wayland, Fedora 43 base).

The Terra docs at https://developer.fyralabs.com/terra/installing#bazzite-and-aurora state:

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

but on my system the Terra repo was not enabled initially. rpm-ostree install espanso-wayland failed with “Packages not found”, and the enabled rpm-md repos listed were only fedora, updates, etc.

Running the “Fedora Atomic and Derivatives” steps from the Terra docs fixed it immediately:

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

After that, I could find and install the package I was looking for.

Suggestion:

In the “Bazzite and Aurora” section, add a one-line verification step (e.g., confirm terra appears in rpm-ostree enabled repos / confirm rpm-ostree search terra-release returns results), and if not present, point users to the Atomic repo-file + terra-release instructions.

This would prevent a lot of confusion for new users unfamiliar with the way this works, because the current text reads as unconditional!

Thanks!

[nothingneko]

it was a recent change in both to disable Terra after build time, you can simply edit the repo file at /etc/yum.repos.d/terra.repo i'll update the docs

[JdotCarver]

Ah, I see. Unfortunate timing for me then.
Thanks for the update!
🙏