Skip to main content
API Preview
Developers

Install on Arch Linux (AUR)

Install ~alter’s L3 sovereign daemon on Arch Linux and Arch-based distributions (Manjaro, EndeavourOS, Garuda) via the Arch User Repository. The package wraps the upstream truealter PyPI distribution and registers a systemd user service named alter-runtime.

What you get

  • •alter-runtime binary on $PATH.
  • •Systemd user unit alter-runtime.service for socket-activated startup.
  • •Default config root at $XDG_CONFIG_HOME/alter/ and runtime socket at $XDG_RUNTIME_DIR/alter-runtime.sock.

Install

The release package pins to the most recent published truealter PyPI version. The -git variant tracks the upstream daemon’s main branch for early adopters.

yay -S alter-runtime

Need the CLI too? The alter CLI is distributed via npm and works alongside the daemon. See the npm install guide for details.

Start the daemon

bash
systemctl --user enable --now alter-runtime.service

Verify

bash
alter-runtime --version
systemctl --user status alter-runtime.service

Cross-platform unity

However a person installs alter-runtime, the runtime they get is the same runtime everyone else gets: same socket protocol, same ~handle resolution, same DNS-TXT discovery, same federation endpoints. Per-distro packaging optimises for local idioms (PKGBUILD on Arch, .deb on Debian, Formula on macOS) without diverging the substrate. The full operative invariants are documented in packaging/README.md.

Next steps

Getting started

Bind a ~handle and make your first authenticated request.

~handle protocol

How ~handle resolution works on top of the running daemon.