Skip to main content
API Preview
Developers

Install on Alpine Linux (apk)

Install ~alter’s L3 sovereign daemon on Alpine Linux (edge or stable branches) and Alpine-derived containers via apk. The package builds from the upstream truealter PyPI sdist and ships with an OpenRC service script (with a systemd unit fallback for the alpine-systemd overlay).

What you get

  • •alter-runtime binary on $PATH.
  • •OpenRC service /etc/init.d/alter-runtime (systemd unit on alpine-systemd).
  • •Default config root at $XDG_CONFIG_HOME/alter/ and runtime socket at $XDG_RUNTIME_DIR/alter-runtime.sock.

Install

The package will be available from the Alpine community repository on edge once the repository is published.

bash
sudo apk add 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

sudo rc-update add alter-runtime default
sudo rc-service alter-runtime start

Verify

bash
alter-runtime --version
sudo rc-service alter-runtime status

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. Alpine’s OpenRC service script is a local-idiom optimisation; the substrate is identical to systemd-based installs. 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.