Self-hosted deployment

Installs in about 15 minutes. Full org live in 45.

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.

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.

What Wardhand creates

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.

What it never creates

No public IP address, no SSH listener, no vendor telemetry, and no standing database-owner credentials on the running container.

From OpenTofu plan to live organization scan.

Step-by-step installation path

~15 min cold install · ~45 min full onboarding
Security invariant
A cold install takes about 15 minutes once prerequisites are ready. Plan about 45 minutes total to test sign-in, connect your AWS Organization, and upload your first policy.

1. Provision private infrastructure with OpenTofu (>= 1.8)

Workstation

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

No public IPNo SSH

2. Initialize host & temporary 15-minute database bootstrap

SSM + Workstation

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

15-min trustverify-full TLS

3. Run host doctor & sign in over VPN or SSM

Verification

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

--read-only--cap-drop ALL

4. Adopt your AWS Organization with one StackSet (reader policy v5)

Multi-account

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

53 checksAuto-adopts new accounts

5. Upload your written security policy into Policy Truthkeeper

Optional AI

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

PDF · DOCXPage quotes

Exact workstation & host sequence.

No mystery install scripts. Every step uses standard OpenTofu and verified commands extracted from your pinned container digest.

Workstation · OpenTofu provision
# 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
Host (root SSM) · initialize, bootstrap & start
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

Sign in with Microsoft Entra, Okta, or Google Workspace.

Register the callback https://<private-host>/auth/oidc/callback, store the client secret in Secrets Manager, and pass only its ARN.

Microsoft Entra ID

OIDC + Groups

Single-tenant app registration with tenant ID, client ID, and allowed domains. Optional security groups map directly to Admin, Approver, and Viewer roles.

Okta

Auto group admission

Maps Okta groups straight to Admin, Approver, and Viewer roles with no manual invitations. Removing someone from a group revokes their active session.

Google Workspace

Domain lock + invite

Locks sign-in to your Workspace domain and refuses personal @gmail.com accounts. Teammates join after an admin invites them in System > People & roles.

Fifteen minutes to a locked private runtime.

Temporary bootstrap credentials close before the server starts, leaving the runtime with least privilege from day one.

Cold install & bootstrap lock lifecycle ~15 min infra · ~45 min full org
~15m COLD INSTALL DB ROLE LOCKED
1
OpenTofu >= 1.8 provisions private VPC resources Pinned container digest, no public IP, and OIDC secret referenced by ARN from Secrets Manager.
2
15-minute temporary DB bootstrap opens, migrates, and locks shut An explicit Deny policy closes bootstrap before the runtime container ever starts.
3
Verify OIDC sign-in & adopt fleet via StackSet v5 One StackSet covers chosen Organizational Units and shows new accounts for an admin to adopt.

Want us on the call for your first install?

We walk through OpenTofu, reader policy v5, and StackSet setup live in a 60-minute pilot.