Run the full Teable platform on your own infrastructure.

Just want to try Teable (AI Spreadsheet, APP Builder, AI Workflows)? Use teable.ai — nothing to deploy.

Two planes working together:

• The Teable app — the product itself, with its PostgreSQL and Redis.
• The AI runtime plane — what powers AI chat, the App Builder and app deployments: a sandbox engine (AI sessions run inside sandboxes), the Infra Service (console + API that the app talks to), a git registry (source of the apps you build), object storage (attachments and build artifacts), and a preview gateway.

Everything hangs off one base domain — typically a subdomain of yours, e.g. teable.example.com. Four DNS records cover the whole platform:

<domain>              the Teable app
infra.<domain>        Infra console + API (git and object storage ride it as paths)
*.app.<domain>        apps you built and deployed
*.sandbox.<domain>    sandbox previews in the browser

(Each name is only a default — every hostname can be overridden individually.)

Both deployment paths below install the same platform; they differ only in where it runs.

The paths are independent: Docker users never need Kubernetes concepts, and Kubernetes users never need to read the compose files.

Run the doctor for your path first, then see TROUBLESHOOTING.md:

cd docker/all-in-one && ./doctor.sh    # Docker
./helm/doctor.sh                       # Kubernetes

Already running the basic (standalone) Teable and want the AI features? Your data stays where it is — you add the runtime plane next to it: migration/ — start with 2026-07-basic-to-full-featured.md.

Each release of this repository pins a compatible set of images — see VERSIONS.md. Docker deployments default to latest and just work; production Kubernetes deployments should pin versions and upgrade deliberately.