Quickstart

This is the fastest path from "I just installed Tako" to "my app is live."

Local setup

Install the CLI:

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

Verify installation:

tako --version

From your app directory:

• Install the SDK (Bun example):

bun add tako.sh

• Start local HTTPS development:

tako dev

On your first tako dev run, Tako will ask for your sudo password to set up local no-port HTTPS and custom *.test URLs. This happens once and is reused for other apps.

Open the URL shown in the terminal header. By default, Tako uses {app}.test, where {app} is your app name. The longer {app}.tako.test form is always available as a fallback.

Remote setup

On each deployment host (as root or with sudo), install the runtime:

sudo sh -c "$(curl -fsSL https://tako.sh/install-server.sh)"

Verify installation:

tako-server --version

First deployment

From your developer machine, add the server you set up in Remote setup to Tako:

tako servers add <host-or-ip>

Run the following commands from your app directory.

Initialize Tako config:

tako init

tako init prompts for app name and production route, writes them to tako.toml, and updates .gitignore so .tako/secrets.json stays trackable.

tako dev uses {app}.test by default. Add [envs.development] only when you want custom local routes.

Deploy:

tako deploy

Need every config option? See the full tako.toml reference.

Need framework adapter examples? See Framework Guides.