Install Standalone AuthOS

Install and verify the standalone SQLite AuthOS bundle on a Linux host.

AuthOS release 0.8.5 Latest-only documentation

This procedure installs AuthOS. It ends when the process and database are ready; platform configuration and application integration are separate guides.

Prerequisites

  • A Linux host with systemd
  • python3, curl, tar, mktemp, sha256sum, and openssl
  • Permission to install and manage a system service
  • A pinned AuthOS release that you have evaluated

Install the standalone bundle

The v0.8.5 installer verifies release checksums and the expected archive inventory before installing files. Pin the exact release you evaluated instead of installing an unreviewed latest release.

AUTHOS_VERSION=v0.8.5
curl -fsSL -o install.sh "https://github.com/drmhse/AuthOS/releases/download/${AUTHOS_VERSION}/install.sh"
chmod +x install.sh
sudo AUTHOS_RELEASE_TAG="${AUTHOS_VERSION}" ./install.sh

The installer detects amd64 or arm64, downloads the matching SQLite bundle, starts AuthOS, and prints a one-time bootstrap login link. Preserve that link for the platform owner who will perform setup.

If installation is interrupted after managed state is written, retry the managed apply step:

sudo authos-apply apply --bundle-dir /opt/authos

Verify installation

curl http://YOUR_HOST:3001/health
curl http://YOUR_HOST:3001/health/ready

The default standalone endpoint is http://YOUR_HOST:3001. Do not install frontend or backend packages on this host merely to validate the service.

Completion check

  • The installer exits successfully and prints the AuthOS URL and bootstrap link.
  • /health confirms that the process serves requests.
  • /health/ready confirms that the process and database are ready.
  • The bootstrap link has been transferred securely to the platform owner.

Next steps

Continue to Set up the platform. For database, key, reverse-proxy, and public-origin planning beyond the standalone path, use the Deployment Guide.