https://github.com/lilienblum/tako
Build, run, and manage app instances anywhere, without thinking about the boring stuff
https://github.com/lilienblum/tako
application-server bun deploy development-server development-tools load-balancer reverse-proxy tls-certificate
Last synced: 8 days ago
JSON representation
Build, run, and manage app instances anywhere, without thinking about the boring stuff
- Host: GitHub
- URL: https://github.com/lilienblum/tako
- Owner: lilienblum
- License: mit
- Created: 2026-02-10T05:49:01.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2026-04-29T04:23:23.000Z (about 1 month ago)
- Last Synced: 2026-04-29T06:31:24.547Z (about 1 month ago)
- Topics: application-server, bun, deploy, development-server, development-tools, load-balancer, reverse-proxy, tls-certificate
- Language: Rust
- Homepage: https://tako.sh
- Size: 15.5 MB
- Stars: 31
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/tako.sh)
## What is Tako?
Ship apps to your own servers without turning deployment into a part-time job.
Tako gives you the "upload files, refresh, done" feeling with modern guardrails: rolling deploys, load balancing, HTTPS, secrets, and logs out of the box.
Tako is not just a deployment tool. The vision is a self-hosted application platform: the backend for your backend.
Deployment is the starting point, not the finish line. Over time, Tako should provide the core primitives teams end up rebuilding in every stack: durable channels, workflows, and other platform capabilities built into one tool instead of stitched together from many.
## Install
Install the CLI:
```bash
curl -fsSL https://tako.sh/install.sh | sh
```
Verify:
```bash
tako --version
```
Start local development from your app directory:
```bash
bun add tako.sh # or: npm install tako.sh
tako dev
```
Set up a deployment host:
```bash
# Connect the host and your workstation to Tailscale first.
# The host installer bootstraps only; servers add starts and verifies it.
sudo sh -c "$(curl -fsSL https://tako.sh/install-server.sh)"
tako servers add my-server
# Or install/repair over SSH while adding:
tako servers add root@my-server
# Custom public ports:
tako servers add root@my-server --http-port 8080 --https-port 8443
```
Deploy your app:
```bash
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.
# Deploy verifies the token is active and can read 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 the provider token:
tako credentials set ssl.cloudflare --env production --expires-on "in 90 days"
tako deploy
```
## Quick links
- [Quickstart](https://tako.sh/docs/quickstart) — install to live in minutes
- [How Tako Works](https://tako.sh/docs/how-tako-works) — architecture and mental model
- [tako.toml Reference](https://tako.sh/docs/tako-toml) — every config option
- [CLI Reference](https://tako.sh/docs/cli) — all commands and flags
- [Framework Guides](https://tako.sh/docs/framework-guides) — adapter examples
- [Local Development](https://tako.sh/docs/development) — HTTPS, DNS, environment variables
- [Deployment](https://tako.sh/docs/deployment) — deploy flow, rolling updates, rollbacks
- [Troubleshooting](https://tako.sh/docs/troubleshooting) — common issues and fixes
- [Examples](https://github.com/lilienblum/tako/tree/main/examples)
- [SDK](https://www.npmjs.com/package/tako.sh)
## License
MIT — see [LICENSE](LICENSE).