Install Standalone AuthOS

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 currently published v0.8.2 installer predates automatic bundle-checksum verification. Hardened checksum and archive-inventory checks apply only after a later release completes the updated public release workflow. Pin the exact release you evaluated instead of assuming latest includes those controls.

AUTHOS_VERSION=v0.8.2
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.