Skip to main content
API Preview
Developers

Install on Debian and Ubuntu (apt)

Install ~alter’s L3 sovereign daemon on Debian, Ubuntu, and derivatives (Mint, Pop!_OS, KDE Neon, Devuan, Raspbian) via apt. The package builds from the upstream truealter PyPI sdist using pybuild and registers a systemd user service.

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 apt source

The release apt source will be hosted at releases.truealter.com/apt once the repository is published. When it is live, import the signing key and register the source list:

bash
# Import the release signing key
sudo curl -fsSL https://releases.truealter.com/apt/keyring.gpg \
  | sudo tee /usr/share/keyrings/truealter-archive-keyring.gpg > /dev/null

# Register the apt source
echo "deb [signed-by=/usr/share/keyrings/truealter-archive-keyring.gpg] \
  https://releases.truealter.com/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/truealter.list > /dev/null

sudo apt update

Install

bash
sudo apt 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.