Skip to content
Docs

Run and operate

Open the admin console

What this is
  1. Open /admin and sign in with an admin account.
  2. Read the account, site, and usage lists before changing anything.
  3. For a client, request GET /v1/admin/usage with the admin key and inspect workers.

Take down a site

What this is
  1. Read GET /v1/admin/sites and identify the site’s ID.
  2. Confirm the site, then send POST /v1/admin/sites/{id}/suspend.
  3. To undo the takedown, send POST /v1/admin/sites/{id}/restore.

Check server health

What this is
  1. Request GET /healthz and check for HTTP 200.
  2. If it fails, read the server’s startup logs and check database connectivity.
  3. On your own server, run simple-host migrate -status to check pending migrations.

Prepare an installation

What this is
  1. Open Setup and choose the installation type.
  2. Fill in the server addresses and settings.
  3. Download the generated configuration and follow its commands on your own server.

Run your own copy

What this is
  1. Follow the installation instructions for your server.
  2. Set this install’s address and apply its database schema or migrations before starting it.
  3. Open /healthz, sign in, and publish a test site. Use the settings reference when changing limits or providers.

Prepare storage retirement notices

The operator’s migrate-rules --list-recipients --out recipients.json command writes private recipient lists and sends nothing. Add --legacy-log with collected legacy_storage_call lines to include sites that call older saved-data routes without storing rows. Recompute before each approved send. File buckets are excluded; event-held resources are listed separately.

Leave STORAGE_SWITCH_AT empty until the notice date is approved. It accepts an RFC3339 UTC instant and requires STORAGE_RULES=on. Set it in the Compose environment or Helm storageSwitchAt value, then restart. During the notice period successful SQLite/KV preset saves return a warning. Wording may be changed without rebuilding through DATA_DIR/storage-notice.json. See Storage and backups.