Skip to content
Esc

Introduction

What Dockmesh is, what it manages, and what it deliberately leaves out.

Dockmesh is a self-hosted manager for Docker hosts. One server gives you a web UI and a REST API for compose stacks, containers, images, volumes and networks on the machine it runs on, and on any number of remote hosts that run a small agent.

It is meant for people who already run Docker and Docker Compose and want one place to deploy, watch and back up what runs on their hosts, without moving to a cluster scheduler.

  • Stacks: compose projects stored as compose.yaml files on disk. You edit, deploy, stop and roll them back in the UI; dmctl can deploy and stop them, and you can also edit the files directly. See Stacks.
  • Containers, images, volumes, networks on every connected host: logs, a terminal into running containers, live stats, and a file browser.
  • Hosts: the local host the server runs on, plus remote hosts whose agents connect to the server. See Hosts and agents.
  • Around the stacks: users and roles, single sign-on, API tokens, backups, alerts and notifications, an audit log, image vulnerability scans and an optional reverse proxy.

The web UI is available in English and German; each user picks the language, see First steps.

BinaryRuns onPurpose
dockmeshthe server hostThe server: HTTP API, embedded web UI, SQLite database, scheduler. Talks to the local Docker engine through the Docker API. Also carries admin subcommands (init, doctor, admin, db, restore, …).
dockmesh-agenteach remote hostConnects out to the server over a mutually authenticated TLS WebSocket and carries out Docker operations on its host. Remote hosts need no open inbound ports.
dmctlyour workstation or CICommand-line client for the REST API: sign in, list and deploy stacks, follow logs, run backups. See dmctl.

Each release archive contains all three. The web UI is compiled into dockmesh, so there is no separate frontend to deploy.

  • Compose files on disk are the source of truth. Each stack is a directory under the stacks root (<stacks>/<name>/compose.yaml, plus an optional .env). The database holds runtime state such as deployments, history, users and settings, not your stack definitions. You can keep the stacks directory in Git or edit it over SSH.
  • No Kubernetes, no Swarm. Dockmesh drives plain Docker engines through the Docker API and reconciles compose files itself. There is no cluster, no scheduler that places workloads for you and no overlay networking between hosts. Each stack is deployed to one host you choose.
  • SQLite only. The server keeps its state in one SQLite file. There is no option to use Postgres or MySQL.
  • Outbound agents. Remote hosts dial the server; the server never connects to them.
  • Not all compose features are supported. Dockmesh reads compose files with the compose-spec library but creates containers itself, and some keys are ignored, for example depends_on, devices, logging and everything under deploy except deploy.update_config (used by rolling updates). Stacks lists what is applied.
  • External helpers stay external. The reverse proxy, when you enable it, is a separate Caddy container named dockmesh-proxy that the server manages over Caddy’s admin API. Vulnerability scanning runs the grype binary as a subprocess; the installer puts it on the host for you.

Dockmesh is free software under the GNU Affero General Public License, version 3 only (AGPL-3.0-only). Every feature, including roles and single sign-on, is in the open-source code; there is no paid tier. If you modify Dockmesh and offer it to others over a network, the AGPL requires you to make your modified source available to them. The full text is in the LICENSE file of the repository.