Skip to content

docs: fold Arch into the Linux one-liner and manual setup #321

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kipavy merged 1 commit into from
Sep 19, 2026
+17 −10
Merged

docs: fold Arch into the Linux one-liner and manual setup #321

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 5 additions & 9 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,13 +62,13 @@ No account required. Everything below is free, forever.

### <img src=".github/media/icons/linux.svg" alt="" height="22" align="center" /> Linux

One command adds the signed Voltius repository and installs the app on Debian/Ubuntu and Fedora/RHEL:
One command installs the app on Debian/Ubuntu, Fedora/RHEL and Arch:

```bash
curl -fsSL https://repo.voltius.app/setup.sh | sudo bash
```

After that, Voltius updates through your normal `sudo apt upgrade` / `sudo dnf upgrade`. Packages are GPG-signed and provided for both `amd64`/`x86_64` and `arm64`/`aarch64`.
On Debian/Ubuntu and Fedora/RHEL it adds the signed Voltius repository, so updates arrive through your normal `sudo apt upgrade` / `sudo dnf upgrade`. Packages are GPG-signed and provided for both `amd64`/`x86_64` and `arm64`/`aarch64`. On Arch it installs `voltius-bin` from the AUR with `paru` or `yay`.

<details>
<summary>Manual setup</summary>
Expand All @@ -87,17 +87,13 @@ sudo curl -fsSL https://repo.voltius.app/voltius.repo -o /etc/yum.repos.d/voltiu
sudo dnf install voltius
```
On older dnf, replace the `curl` line with `sudo dnf config-manager --add-repo https://repo.voltius.app/voltius.repo`.
</details>

#### <img src=".github/media/icons/archlinux.svg" alt="" height="22" align="center" /> Arch (AUR)

Community-maintained by [ezhkov](https://aur.archlinux.org/account/ezhkov/), not published by this repo's CI:

**<img src=".github/media/icons/archlinux.svg" alt="" height="16" align="center" /> Arch (AUR)**
```bash
yay -S voltius-bin # prebuilt binary, tracks releases
```

`voltius` (builds from source) and `voltius-git` (latest `main`) are also available. If any of these are ever behind, the apt/dnf repo above or a direct download is the maintained fallback.
Community-maintained by [ezhkov](https://aur.archlinux.org/account/ezhkov/), not published by this repo's CI. `voltius` (builds from source) and `voltius-git` (latest `main`) are also available. If any of these are ever behind, a direct download is the maintained fallback.
</details>

### <img src=".github/media/icons/apple.svg" alt="" height="22" align="center" /> macOS — Homebrew

Expand Down
13 changes: 12 additions & 1 deletion repo/setup.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,8 +35,19 @@ elif command -v dnf >/dev/null 2>&1 || command -v yum >/dev/null 2>&1; then
curl -fsSL "$REPO_BASE/voltius.repo" -o /etc/yum.repos.d/voltius.repo
"$PM" install -y voltius
echo "==> Done. Voltius will update via '$(basename "$PM") upgrade'."
elif command -v pacman >/dev/null 2>&1; then
# AUR helpers refuse to run as root, so build as the user who invoked sudo.
AUR_HELPER="$(command -v paru || command -v yay || true)"
if [ -z "$AUR_HELPER" ] || [ -z "${SUDO_USER:-}" ] || [ "$SUDO_USER" = root ]; then
echo "Arch: Voltius is on the AUR as voltius-bin. Install it with an AUR helper as your user:" >&2
echo " yay -S voltius-bin" >&2
exit 1
fi
echo "==> Installing voltius-bin from the AUR with $(basename "$AUR_HELPER")"
sudo -u "$SUDO_USER" "$AUR_HELPER" -S --needed --noconfirm voltius-bin
echo "==> Done. Voltius will update via '$(basename "$AUR_HELPER") -Syu'."
else
echo "Unsupported distribution: need apt-get or dnf/yum." >&2
echo "Unsupported distribution: need apt-get, dnf/yum or pacman." >&2
echo "See $REPO_BASE for manual instructions." >&2
exit 1
fi
Loading