Skip to main content
API Preview
Developers

Install on Fedora, RHEL and openSUSE (rpm)

Install ~alter’s L3 sovereign daemon on Fedora, RHEL/CentOS Stream, Rocky Linux, AlmaLinux, and openSUSE Tumbleweed/Leap via dnf or zypper. A single spec file targets every supported RPM distribution from the upstream truealter PyPI sdist.

What you get

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

Add the repo and install

Pick the channel that matches your distribution. RHEL/Rocky/Alma consume the Fedora COPR build via EPEL; openSUSE pulls from the Open Build Service.

sudo dnf copr enable @truealter/alter
sudo dnf install 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. 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.