Docker on hosts¶
When Docker / containers is enabled for a server, PiHerder can list compose projects, view logs, edit multi-file compose, build, and redeploy. The host Docker page uses the shared ops-hero (project counts / health) consistent with other host pages.
Prerequisites¶
- Feature flag Docker / containers on.
- Remote
dockerusable by the SSH user (group/socket). - Docker base dir set correctly (absolute path if using least-priv).
- Dependency check green for docker — SSH troubleshooting.
What you can do¶
| Action | Notes |
|---|---|
| Browse projects / containers | From inventory snapshot (Inventory) |
| Logs | Per container / service (live stream on full log page) |
| Container start / stop / restart | Row actions on the stack |
| Quick edit / Full editor | ⋯ menu — modal vs multi-file page — Compose edit |
| Multi-file compose edit | compose + override + .env + Dockerfile |
| Version history | Snapshots; rollback |
| Build / redeploy | Wait for job / progress UI |
| Check updates vs Deploy | Pull-only vs pull+up as Jobs — Updates |
| Cleanup unused | List dangling images / exited containers (escaped HTML); optional prune |
| New project wizard | Create a stack on the host |
| Template-managed stacks | Badge + gated full editor — Templates |
Template vs free-form stacks¶
| Kind | Edit path |
|---|---|
| Template-managed | Desired state / redeploy on deployment page; compose editor gated |
| Free-form | Full compose multi-file editor |