GitHubOpen Cloud
Deployment

Self-Hosted

Operator notes for running Private Cloud yourself.

1Prepare
2Configure
3Deploy
4Verify

Rollout Flow

Operator notes for running Private Cloud yourself.

Platform setup:
1. Provision Postgres.
2. Deploy client-api, dashboard-api, and dashboard-web.
3. Run migrations.
4. Store credentials in your secret manager.
5. Expose the client API to desktop/mobile.
6. Expose the dashboard to admins.

Dashboard setup:
1. Configure identity.
2. Sync users and groups.
3. Assign roles.
4. Configure policies and provider keys.
5. Issue deployment tokens.
6. Roll out clients.

Client bootstrap:
desktop: Organization -> Private Cloud -> your managed API URL -> sign in -> install hooks
mobile:  Custom API URL -> sign in -> register device -> approve held actions
Admin configures dashboard
Identity and roles
Policies and approvals
Desktop rollout
Mobile approvals

Operator Notes

Keep these in mind before you release or upgrade.

Self-hosted is the operator-run form of Private Cloud, not a separate product mode.
Document services, secrets, ingress, migration jobs, and backups.
Keep Local Mode free of Postgres and dashboard requirements.

Complete When

Use this as the practical finish line for the rollout.

Admins can sign in to the right OpenLeash surface
Identity, users, roles, and policies are saved
A deployment token or install path exists
At least one desktop client is enrolled
A test risky action is allowed, held, or denied as expected