Skip to content

Custom Domains & Sandboxes

Kiket can run behind any domain — production, staging, or isolated sandboxes — without editing source code. Set the following environment variables (or Cloud Build substitutions) before deploying:

Variable Description Default
KIKET_BASE_DOMAIN Canonical domain for the workspace kiket.dev
APP_HOST Hostname that serves the web app KIKET_BASE_DOMAIN
DOCS_HOST Documentation hostname docs.${KIKET_BASE_DOMAIN}
STATUS_HOST Status page hostname status.${KIKET_BASE_DOMAIN}

Cloud Build / Cloud Run

Example deployment snippet:

substitutions:
  _BASE_DOMAIN: sandbox.acme.dev
  _APP_HOST: sandbox.acme.dev
  _DOCS_HOST: docs.sandbox.acme.dev
  _STATUS_HOST: status.sandbox.acme.dev

steps:
  - name: gcr.io/google.com/cloudsdktool/cloud-sdk
    args:
      - run
      - deploy
      - kiket
      - --set-env-vars=KIKET_BASE_DOMAIN=${_BASE_DOMAIN},APP_HOST=${_APP_HOST},DOCS_HOST=${_DOCS_HOST},STATUS_HOST=${_STATUS_HOST}

PlatformHost (built into the app) uses these values for URLs, email links, telemetry, and Action Cable host allow-lists.

Terraform & Cloudflare

Provide the same domains to Terraform (domain_name, docs_domain_name, status_domain_name) so Cloudflare DNS and HTTPS bindings match your deployment. When creating sandboxes, generate a dedicated tfvars file per tenant and run terraform apply with those values.

CLI / SDKs

Set KIKET_API_URL (CLI) or KIKET_BASE_URL (SDKs) to point at the sandbox host. When the platform is deployed with the environment variables above, the command palette, workflows, and extensions automatically reference the correct URLs.