Skip to main content

Deployment

How to ship Digitorn apps you wrote in YAML: local installs, cloud preview, and production hardening tips for the app file.

Pages

PageWhat it covers
Cloud previewPreview surfaces behind a reverse proxy
Production checklistHarden app.yaml (capabilities, credentials, sandbox)
Multi-tenant installsSystem-wide vs per-user apps

Local shape

  1. Install Digitorn (Install).
  2. digitorn lint my-app.yaml
  3. digitorn install my-app.yaml
  4. digitorn chat my-app (conversation apps) or wait for triggers (background apps).

Production tips for app authors

  • tools.capabilities.default_policy: block with explicit grants
  • Declare security.credentials_schema for user-supplied keys
  • Prefer deny lists for write / shell when the agent is read-only
  • Keep secrets in {{secret.X}}, never inline in git
  • See YAML building blocks

Operational hosting details (process layout, reverse proxies) belong with your platform team; these docs stay focused on the app YAML you deploy.