diff --git a/README.md b/README.md
index cdd0bdfe3..093b0dc21 100644
--- a/README.md
+++ b/README.md
@@ -62,13 +62,13 @@ No account required. Everything below is free, forever.
###
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`.
Manual setup
@@ -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`.
-
-
-####
Arch (AUR)
-
-Community-maintained by [ezhkov](https://aur.archlinux.org/account/ezhkov/), not published by this repo's CI:
+**
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.
+
###
macOS — Homebrew
diff --git a/repo/setup.sh b/repo/setup.sh
index 7d9ad2990..c5a0c7113 100644
--- a/repo/setup.sh
+++ b/repo/setup.sh
@@ -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