The application platform for solo builders

What is Tako?

Tako is a complete, opinionated application platform for solo builders, running on your own VPS.

Local development, rolling deploys, HTTPS, logs, secrets, workflows, channels, storage, and more work together in one platform designed to stay manageable by one person.

Keep control of your infrastructure, data, and costs, with access to a full runtime: Node.js, Bun, Go, an application packaged with a Dockerfile, or an existing Docker Compose stack on one server.

Tako chooses a simple workflow and thoughtful defaults so you can build and run your application without assembling a platform yourself. Start on one VPS; run the same app on multiple servers when needed.

Install

Install the CLI:

curl -fsSL https://tako.sh/install.sh | sh

Verify:

tako --version

Start local development from your app directory:

bun add tako.sh   # or: npm install tako.sh
tako dev
# optional temporary public URL:
tako dev --tunnel

Set up a deployment host:

# Connect the host and your workstation to Tailscale or NetBird first.
# If needed, servers add offers to install the service over SSH.
sudo sh -c "$(curl -fsSL https://tako.sh/install-server.sh)"
tako servers add my-server
# Install/repair without the interactive confirmation:
tako servers add my-server --install
# Use a non-root administrator when root SSH access is disabled:
tako servers add ubuntu@my-server
# Custom public ports:
tako servers add my-server --http-port 8080 --https-port 8443

Deploy your app:

tako init    # prompts for app name + route, offers wildcard HTTPS setup, writes tako.toml
tako servers add my-server
# Optional: Let’s Encrypt wildcard certificates via Cloudflare DNS-01; traffic can stay DNS-only/direct.
# Use a user or account API token with Zone Read and DNS Write for the matching Cloudflare zone.
tako credentials set ssl.cloudflare --env production --expires-on "in 90 days"
# Optional: Cloudflare Origin CA certificates for Cloudflare-proxied apps.
# Set ssl = "cloudflare" in tako.toml, then store a token with Zone / SSL and Certificates / Edit:
tako credentials set ssl.cloudflare --env production --expires-on "in 90 days"
tako deploy

Quick links

• Quickstart — install to live in minutes
• How Tako Works — architecture and mental model
• Channels — durable SSE and WebSocket streams
• Presence — authenticated live membership and React hooks
• Stores — live backend data with optional cached offline reads
• Workflows — durable jobs, retries, schedules, and signals
• tako.toml Reference — every config option
• CLI Reference — all commands and flags
• Framework Guides — adapter examples
• Local Development — HTTPS, DNS, environment variables
• Deployment — deploy flow, rolling updates, rollbacks
• Troubleshooting — common issues and fixes
• Examples
• SDK
• Benchmarks — current TLDR and raw-data links
• Runtime Protocol — contracts shared by the CLI, server, and SDKs

Agent Skills

Install Tako skills for Codex, Claude Code, Cursor, and other skills.sh-compatible agents:

npx skills add tako-sh/tako

Install a specific skill with --skill tako, --skill tako-sdk-js, --skill tako-sdk-go, or --skill tako-sdk-rust.

License

MIT — see LICENSE.

Coding agents

Run tako agents to configure your coding agents with Tako workflow skills and MCP tools for development, logs, diagnostics, and deployment. Interactive tako init offers the same setup. Skills and documentation ship with the CLI; skills are also installable with npx skills add tako-sh/tako.

See the coding agent guide for supported clients, manual MCP setup, and automation options.