Skip to content

PaaS Runtime — Documentation

Build, deploy, and operate apps on the PaaS platform — like Heroku, but self-hosted on your cluster.

Get started in 5 minutes

Install the CLI, create an app, push your code:

# 1. Install the paas CLI
curl -fsSL https://get.di2amp.com/install.sh | sh

# 2. Authenticate
paas login

# 3. Create your first app
paas apps create hello

# 4. Push your code
git push paas main

# 5. See your app live
curl https://hello.runtime.di2amp.com/

What's available

  • :material-rocket-launch: Quick Start

    Step-by-step guides for Node.js, Python, Go, Rust, Java, Ruby, PHP and Elixir.

  • :material-book-open-variant: Concepts

    Apps, Deploys, Processes, Add-ons, Environments — the building blocks.

  • :material-console-line: CLI Reference

    All paas commands with flags and examples.

  • :material-api: API Reference

    REST API spec — the same one used by the dashboard and CLI.

  • :material-compass-rose: Guides

    Migrate from Heroku, set up a custom domain, debug a failing deploy.

  • :material-file-document-outline: Reference

    paas.toml schema, environment variables, deploy hooks.

What is PaaS Runtime?

PaaS Runtime is a Heroku-style platform that runs on your own Kubernetes cluster. You get:

  • Git push to deploy — git push paas main builds and rolls out
  • 12 lazy-loaded dashboard pages — apps, deploys, logs, metrics, addons, settings…
  • Managed addons — PostgreSQL (CNPG), Valkey, OpenSearch, with PITR backups
  • Dark mode + a11y — aria-label everywhere, dark theme toggle in the topbar
  • Observability built-in — SigNoz traces, Grafana dashboards, structured logs

Need help?

  • Check the Guides for common workflows
  • Search the docs (top right)
  • File an issue at forgejo.di2amp.com/octave/paas-runtime