Developer Documentation

Everything you need to connect your multi-cloud infrastructure, install node agents, and automate operational workflows with AutoMonOP.

1. Getting Started in 3 Minutes

AutoMonOP can be accessed directly via our hosted command center or self-hosted on your own infrastructure using Docker Compose.

# Clone and spin up local operational stack:

git clone https://github.com/freecer21/AutoMonOP.git

cd AutoMonOP

docker compose -f docker-compose.local.yml up -d

2. Node Agent Installation

The AutoMonOP Node Agent is packaged as an Inno Setup 6 installer for Windows and a standard systemd service for Linux.

Windows Inno Setup Installer

Download the latest automonop-node-setup-0.1.0.exe installer. It configures the Windows service, registers start-on-boot keys, and isolates local_node.db state into your user application directory.

.\automonop-node.exe --version
.\automonop-node.exe --uninstall # Clean uninstall and state eviction

3. Cloud Provider Telemetry

AutoMonOP connects to your cloud providers without storing long-lived API secrets (ADR-0031). Pass provider tokens through environment variables:

Railway

Provide RAILWAY_API_TOKEN. AutoMonOP continuously monitors build deployments, active container instances, and error logs.

Fly.io

Provide FLY_API_TOKEN. Queries the Machines API for memory usage, regional distribution, and auto-stop statuses.

Supabase

Provide SUPABASE_ACCESS_TOKEN. Tracks connection pool pressure, disk quota, and backup completion events.

4. AutoMono Core SSO & Microfrontend

AutoMonOP implements the ecosystem standard <automono-auth> Web Component microfrontend. Embedded on /login, it supports WebAuthn/Passkeys, 2FA step-up, and token exchange via:

POST /api/v1/auth/sso/token
Body: { "token": "<automono_core_jwt>" }