Repolode
Submit
RA341

RA341/dockman

A Docker management tool that works directly on your Docker Compose files for homelab users.

View on GitHubWebsite
Stars
646
Forks
25
Open issues
35
Last commit
11 days ago

What is it?

Dockman is a web-based manager for Docker containers and Compose stacks, aimed at self-hosters running services in a homelab. Instead of hiding configuration behind its own abstraction, it works on the Compose files you already keep on disk, so you retain full control over the YAML that defines your services.

You run Dockman as a container that mounts the Docker socket and a directory of stacks. The stacks directory path must be absolute and match between the environment variable, the host volume, and the container volume. Dockman is licensed under AGPL-3.0 and is written in TypeScript.

A quick-start docker run command is provided for testing, but it deletes all Dockman data when the container stops, so a Compose-based setup with a persistent config volume is the intended long-term deployment.

Key features

  • 01Manages Docker Compose stacks directly from their files on disk.
  • 02Requires the Docker socket to be mounted into the container.
  • 03Stores its own configuration in a mounted /config volume.
  • 04Ships as a container image published on ghcr.io.
  • 05Includes a web interface served on port 8866.

Use cases

  • Managing a homelab's self-hosted services through a browser instead of the terminal.
  • Keeping Compose files as the single source of truth for running containers.
  • Editing and redeploying stacks on a home server without learning a new configuration format.

Quick start

  1. 1

    Try Dockman with a temporary docker run (deletes data on stop)

    docker run --rm -p 8866:8866 -e DOCKMAN_LOG_AUTH_WARNING=false -v /var/run/docker.sock:/var/run/docker.sock ghcr.io/ra341/dockman:latest
  2. 2

    Open the web UI at localhost port 8866

Things to know

  • The quick-start docker run command deletes all Dockman data when the container stops, so it is for testing only.
  • Persistent use requires a Docker Compose setup with an absolute stacks path that matches in three places.
  • Licensed under AGPL-3.0, a copyleft license that requires source disclosure for modified network-deployed versions.

In collections

Self-hosted apps

Topics

#docker#docker-compose#homelab#self-hosted#container-management#devops

FAQ

What is dockman?
A Docker management tool that works directly on your Docker Compose files for homelab users. Dockman is a web-based manager for Docker containers and Compose stacks, aimed at self-hosters running services in a homelab. Instead of hiding configuration behind its own abstraction, it works on the Compose files you already keep on disk, so you retain full control over the YAML that defines your services.
Is dockman free to use? What license does it have?
dockman is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is dockman still maintained?
Actively maintained. The last commit to dockman was on Oct 27, 2026.
What can I use dockman for?
Managing a homelab's self-hosted services through a browser instead of the terminal. Keeping Compose files as the single source of truth for running containers. Editing and redeploying stacks on a home server without learning a new configuration format.
How do I install dockman?
Try Dockman with a temporary docker run (deletes data on stop): docker run --rm -p 8866:8866 -e DOCKMAN_LOG_AUTH_WARNING=false -v /var/run/docker.sock:/var/run/docker.sock ghcr.io/ra341/dockman:latest Open the web UI at localhost port 8866
Where can I get dockman?
The source code and installation instructions are on GitHub: https://github.com/RA341/dockman

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects