What you need ready
An existing VPC with outbound HTTPS, private DNS, and private subnets across two zones. Plus VPN or SSM access, OpenTofu >= 1.8, a TLS certificate, and your OIDC secret.
Self-hosted deployment
Wardhand deploys with OpenTofu inside your own VPC. It creates one ARM64 host, Single-AZ PostgreSQL, an internal load balancer, two KMS keys, and locked storage.
An existing VPC with outbound HTTPS, private DNS, and private subnets across two zones. Plus VPN or SSM access, OpenTofu >= 1.8, a TLS certificate, and your OIDC secret.
One ARM64 server, Single-AZ PostgreSQL with verify-full TLS, and an internal HTTPS load balancer. Also two KMS keys, locked S3 storage (Object Lock), and a retained disk.
No public IP address, no SSH listener, no vendor telemetry, and no standing database-owner credentials on the running container.
Put only public values in your .tfvars file, and store your OIDC secret in Secrets Manager. Run tofu apply, then point private DNS at the internal load balancer.
Pinned image digest
Extract the host helper from the pinned image and verify your license and signing key offline. Open bootstrap_open=true for migrations, then close it before starting Wardhand.
DB owner role closed
Run doctor inside a read-only container with --cap-drop ALL and confirm /api/health returns 200. Then sign in as the first admin through Entra, Okta, or Google Workspace.
Host & OIDC verified
Connect wardhand-organizations-reader in your management account, pick your units, and deploy the frozen v5 StackSet. Remove any older wardhand-collector role first, then click Sign adoption.
Reader policy v5
Upload a .pdf, .docx, .md, or .txt policy (up to 2 MiB and 100 pages). Wardhand locks the original, tells you when a clause is weaker than the baseline and why, and binds signed rules to checks.
Original sealed in S3
No mystery install scripts. Every step uses standard OpenTofu and verified commands extracted from your pinned container digest.
# 1. Provision private VPC resources cd deploy/install/aws tofu init tofu fmt -check && tofu validate tofu plan -var-file=/protected/customer.tfvars -out=/protected/install.plan tofu apply /protected/install.plan # 2. Open 15-min bootstrap trust, run migrations on host, close immediately tofu apply -var-file=/protected/customer.tfvars -var=bootstrap_open=true # (run host.py bootstrap via SSM, then close:) tofu apply -var-file=/protected/customer.tfvars -var=bootstrap_open=false
cloud-init status --wait python3 /opt/wardhand/extract-host.py python3 /opt/wardhand/host.py initialize-state python3 /opt/wardhand/host.py prepare # While bootstrap_open=true on workstation: python3 /opt/wardhand/host.py bootstrap # After bootstrap_open=false on workstation: python3 /opt/wardhand/host.py close-bootstrap systemctl enable --now wardhand
Register the callback https://<private-host>/auth/oidc/callback, store the client secret in Secrets Manager, and pass only its ARN.
Single-tenant app registration with tenant ID, client ID, and allowed domains. Optional security groups map directly to Admin, Approver, and Viewer roles.
Maps Okta groups straight to Admin, Approver, and Viewer roles with no manual invitations. Removing someone from a group revokes their active session.
Locks sign-in to your Workspace domain and refuses personal @gmail.com accounts. Teammates join after an admin invites them in System > People & roles.
Temporary bootstrap credentials close before the server starts, leaving the runtime with least privilege from day one.
We walk through OpenTofu, reader policy v5, and StackSet setup live in a 60-minute pilot.