Dokku
Dokku is a PaaS; commands run on the Dokku host (SSH or local). Prefer running long operations (deploys, builds) in the background — use exec with background: true or short yieldMs when the tool allows.
Section index
Detailed command syntax and examples live in each section file. Read the relevant file when performing that category of task.
| Section |
File |
Commands / topics |
| Apps |
apps/commands.md |
create, destroy, list, rename, clone, lock, unlock, report |
| Config |
config/commands.md |
get, set, unset, export |
| Domains |
domains/commands.md |
add, set, remove, set-global, report |
| Git / deploy |
git/commands.md |
from-image, set, deploy-branch, git push |
| Run (one-off / background) |
run/commands.md |
run, run:detached |
| Logs |
logs/commands.md |
logs, logs:failed, logs:set |
| Process (ps) |
ps/commands.md |
scale, rebuild, restart, start, stop |
| Plugin |
plugin/commands.md |
list, install, update, uninstall |
| Certs |
certs/commands.md |
add, remove, generate |
| Nginx |
nginx/commands.md |
build-config, show-config, set |
| Storage |
storage/commands.md |
mount, list |
| Network |
network/commands.md |
report, bind-all-interfaces |
| Install |
install/commands.md |
Installing Dokku (bootstrap, post-install, alternatives) |
| Upgrade |
upgrade/commands.md |
Upgrading Dokku; check migration guides before upgrading |
| Cleanup |
cleanup/commands.md |
Cleaning up Dokku and containers (prune, builder prune, apps) |
Quick reference
- Create app:
dokku apps:create <app-name>
- Deploy (git): Add remote
dokku@<host>:<app-name>, then git push dokku <branch>:master
- Deploy (image):
dokku git:from-image <app> <docker-image>
- Run in background (Dokku):
dokku run:detached <app> <cmd> or dokku run --detach <app> <cmd>
- Agent-side background: For long deploys/installs, run the shell command via exec with
background: true or short yieldMs; poll or check logs as needed.
For full command details and options, see the section files above.
1---2name: dokku3description: Dokku4---56# Dokku78Dokku is a PaaS; commands run on the Dokku host (SSH or local). Prefer running long operations (deploys, builds) in the **background** — use exec with `background: true` or short `yieldMs` when the tool allows.910## Section index1112Detailed command syntax and examples live in each section file. Read the relevant file when performing that category of task.1314| Section | File | Commands / topics |15| -------------------------- | ------------------------------------------ | ------------------------------------------------------------- |16| Apps | [apps/commands.md](apps/commands.md) | create, destroy, list, rename, clone, lock, unlock, report |17| Config | [config/commands.md](config/commands.md) | get, set, unset, export |18| Domains | [domains/commands.md](domains/commands.md) | add, set, remove, set-global, report |19| Git / deploy | [git/commands.md](git/commands.md) | from-image, set, deploy-branch, git push |20| Run (one-off / background) | [run/commands.md](run/commands.md) | run, run:detached |21| Logs | [logs/commands.md](logs/commands.md) | logs, logs:failed, logs:set |22| Process (ps) | [ps/commands.md](ps/commands.md) | scale, rebuild, restart, start, stop |23| Plugin | [plugin/commands.md](plugin/commands.md) | list, install, update, uninstall |24| Certs | [certs/commands.md](certs/commands.md) | add, remove, generate |25| Nginx | [nginx/commands.md](nginx/commands.md) | build-config, show-config, set |26| Storage | [storage/commands.md](storage/commands.md) | mount, list |27| Network | [network/commands.md](network/commands.md) | report, bind-all-interfaces |28| **Install** | [install/commands.md](install/commands.md) | Installing Dokku (bootstrap, post-install, alternatives) |29| **Upgrade** | [upgrade/commands.md](upgrade/commands.md) | Upgrading Dokku; check migration guides before upgrading |30| **Cleanup** | [cleanup/commands.md](cleanup/commands.md) | Cleaning up Dokku and containers (prune, builder prune, apps) |3132## Quick reference3334- **Create app:** `dokku apps:create <app-name>`35- **Deploy (git):** Add remote `dokku@<host>:<app-name>`, then `git push dokku <branch>:master`36- **Deploy (image):** `dokku git:from-image <app> <docker-image>`37- **Run in background (Dokku):** `dokku run:detached <app> <cmd>` or `dokku run --detach <app> <cmd>`38- **Agent-side background:** For long deploys/installs, run the shell command via exec with `background: true` or short `yieldMs`; poll or check logs as needed.3940For full command details and options, see the section files above.