Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Deployment Methods

Choose a deployment method based on your infrastructure:

MethodBest ForComplexity
Systemd (Bare Metal)Single server, VMs, on-premisesLow
DockerContainer-based environmentsLow
Kubernetes (Helm)Multi-node, high availability, cloud-nativeMedium

All methods use the same Vouch server binary and configuration via environment variables. The deployment method only affects how the process is managed and how configuration is provided.

Verification

Regardless of deployment method, verify the server is running:

# Health check
curl -k https://auth.example.com/health
# Expected: {"status":"healthy"}

# SSH CA public key (if configured)
curl -k https://auth.example.com/v1/credentials/ssh/ca
# Expected: ssh-ed25519 AAAA... vouch-ca@...

# OIDC discovery
curl -k https://auth.example.com/.well-known/openid-configuration
# Expected: JSON discovery document