How-to · Customer-operated

Operate a customer-owned Realm.

Run the complete first-party Anyam product in your own Cloudflare account. Plan each provider effect before the installation changes state.

01

Plan the installation

Inspect the read-only plan from the Anyam checkout.

Shell
anyam realm plan

The plan lists resources, permissions, domains, secret locations, migrations, rollback, destruction checkpoints, and cost observations. A plan does not create a provider resource.

02

Prepare the Worker

Copy the example configuration and replace each customer placeholder.

Shell
cp apps/realm-worker/wrangler.example.jsonc apps/realm-worker/wrangler.jsonc
npm run realm:installation-manifest
npx wrangler secret put ANYAM_OWNER_BOOTSTRAP_TOKEN --config apps/realm-worker/wrangler.jsonc

Keep API tokens, passkeys, refresh credentials, and secret values out of the configuration file.

03

Install and claim ownership

Run the resumable lifecycle, then deploy the customer-owned Worker.

Shell
anyam realm install
npx wrangler deploy --config apps/realm-worker/wrangler.jsonc

Open the owner claim route, enroll a passkey, and authenticate. Inspect /api/operator/status, /api/operator/preflight, and /owner/control-room after authentication.

04

Add Projects and Targets

Import Git or scaffold a Project. Use the Realm for semantic operations.

Shell
Project → Source Space → Workspace → Change → Revision → Landing → Release → Target

Configure each Target with a complete deployment profile. The Target record owns provider identities. Callers do not submit account, script, or credential identifiers.

05

Upgrade, export, and recover

Run the read-only plan before changing the installation.

Shell
anyam realm plan
anyam realm upgrade
anyam realm doctor
anyam realm export
anyam realm restore

The lifecycle stores a credential-free checkpoint and resumes after interruption. Restore activates a quarantined checkpoint. Owner reauthentication and provider reconciliation remain separate steps.

NextRead the architecture ↗Run an example ↗