# Dukoi

> Deploy real apps to an old Android phone and get a live URL. No root, no Termux, no cloud bill.

Install the Dukoi app on the phone, install the CLI on a computer with `curl -fsSL https://dukoi.com/install | sh` (Windows: `irm https://dukoi.com/install.ps1 | iex`), run `dukoi pair` on the same Wi-Fi, then `dukoi deploy` in an app folder. Every command takes `--json` for output an agent can parse. Every page below is Markdown; llms-full.txt has them all in one file.

## Get started

- [Quick start](/docs.md): Go from a phone in a drawer to a live URL in about two minutes. You need a spare Android phone and a computer on the same Wi-Fi.
- [Set up the phone](/docs/phone-setup.md): Android stops apps that run in the background for long. Setup is four steps on the phone, and each one only turns green once Android confirms it.
- [Pair a computer](/docs/pairing.md): Pairing links your computer to the phone with a key, once. There are no passwords, and only paired computers can deploy.
- [AI agents](/docs/ai-agents.md): Ask Claude Code, Codex, Cursor or another coding agent to build an app and put it on your phone. The Dukoi skill tells it what runs on the phone and every command, so the app deploys the first time.

## Templates

- [All templates](/docs/templates.md): Pick one and it’s live on your phone in under a minute. Then change one file and deploy again to make it yours.
- [Static site](/docs/templates/static-site.md): A clean one-page site with your name on it. Plain HTML and CSS, no build step. Use it for a portfolio, a link page or a landing page.
- [Notes API](/docs/templates/notes-api.md): A small JSON API with a database, built with Hono. Start here for any backend: add your routes next to the notes ones.
- [File drop](/docs/templates/file-drop.md): Drop a file on a page and get a link to share. The files stay on your phone, not in someone else’s cloud.
- [MCP server](/docs/templates/mcp-server.md): A Model Context Protocol server with tools to save and list notes. Your AI assistant gets a memory that runs on your phone all day.
- [Telegram bot](/docs/templates/telegram-bot.md): A Telegram bot that replies to messages, always on. It asks Telegram for new messages itself, so it needs no public URL.
- [Webhook inbox](/docs/templates/webhook-inbox.md): An address to send webhooks to, and a page that shows each one as it arrives, headers and body. Test Stripe, GitHub or Shopify hooks without a paid tool.
- [Uptime watch](/docs/templates/uptime-watch.md): Your sites checked every minute from your phone, and a push notification when one goes down and when it’s back.
- [Cron jobs](/docs/templates/cron-jobs.md): Run your code on a schedule, all day, on your phone. A page shows when each job runs next and how its last run went.

## Deploy

- [Deploy an app](/docs/deploy.md): Run deploy in your app’s folder. Dukoi works out what the app is and how to start it, so most apps need no config at all.
- [Public URLs](/docs/public-urls.md): Every app gets a Wi-Fi URL when it deploys. One command adds a public HTTPS URL, with no port forwarding or router setup.
- [Custom domains](/docs/custom-domains.md): Put an app on a name like api.example.com. It stays the same across restarts, reboots and reinstalls.
- [Releases and rollback](/docs/releases.md): Every deploy is a release. The phone keeps the last five, so a bad deploy is one command from gone.

## Run

- [Logs](/docs/logs.md): See what your apps print, live, from your terminal, the dashboard or the phone. Dukoi adds its own lines when it restarts something, so you know why.
- [Dashboard](/docs/dashboard.md): Every app on the phone, its status and its live logs, in your browser. It runs on your computer, so only your computer can open it.
- [Battery care](/docs/battery-care.md): A server phone stays plugged in all day. Sitting at 100% wears the battery out and can make it swell, so cap charging at 80%.
- [Benchmark your phone](/docs/bench.md): One command measures how many requests a second your phone can serve, how fast it answers and how warm it gets. Share it to see how it compares on dukoi.com/bench.

## Reference

- [CLI commands](/docs/cli.md): Every command and flag the CLI has today. Commands that take an app use the one in the current folder when you leave it out.
- [Troubleshooting](/docs/troubleshooting.md): Every error says what happened and what to do next. Here are the ones you’re most likely to see, with the fix.

## Optional

- [Home](/index.md): Deploy real apps to the Android phone in your drawer and get a live URL. No root, no Termux, no cloud bill.
- [Agent skill](/skill.md): the rules for apps that deploy first time, every command and its error codes
- [Source code](https://github.com/thisuxhq/dukoi): the phone app, agent, CLI and dashboard