FyraLabs / FyraLabs/devdocs

Feedback for "Install"

Open
#372 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
MDX
Stars
14
Forks
19
Avg merge
7d 12h
Merged PRs (30d)
9

Description

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!

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.