selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

dockge logo

Self-host dockge

1.5.0

Stack-oriented Docker Compose manager with a web UI

ReleaseOpen SourceMIT
Docker ComposeCompose file & guide
docker compose up -d
Updated6 months ago
LanguageTypescript
Setup difficultyEasy
Stars
24 792
Port
5001 (Dockge web UI (container port 5001, mapped 5001:5001))
Requires
Docker socket (/var/run/docker.sock)
Docker
louislam/dockge
Main Dockge dashboard listing compose stacks

What is dockge?

Dockge is a browser-based manager for Docker Compose stacks. Rather than juggling individual containers, you work with named stacks made of compose.yaml files, and it drives them through the Docker socket. It creates, edits, deploys, stops, restarts and deletes stacks, pulls updated images, turns docker run command lines into Compose syntax, and opens a terminal in the browser for each stack. Nothing is locked away: your YAML files remain normal files in a directory on disk, so plain docker compose commands still work, and a folder-scan action picks up stacks you already had. Progress and log output stream live, and since 1.4.0 one interface can manage stacks on several Docker hosts through agents. To run it you launch one container with the docker socket and your stacks path bind-mounted; its site generates the compose file for your chosen port and directory, and updates are a docker compose pull plus re-up. It requires Docker 20+ or Podman on a mainstream Linux distribution; Debian/Raspbian Buster and older, and Windows, are not supported.

Should you self-host dockge?

dockge scores 77/100 on selfhost.directory (how scoring works) and ranks #1 of 5 in Docker Management. It has 24 792 GitHub stars, +235 in the last 30 days.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is doco-cd (62/100, 1 773 stars). dockge scores higher overall. See dockge vs doco-cd side by side.

Features

  • File-based stack storage
  • Multi-host agent support
  • Real-time deployment output
  • Scan stacks folder
  • Web Terminal
  • YAML editor

dockge README

Dockge

A fancy, easy-to-use and reactive self-hosted docker compose.yaml stack-oriented manager.

GitHub Repo stars Docker Pulls Docker Image Version (latest semver) GitHub last commit (branch)

How to install dockge

Install dockge with Docker Compose

Environment variables
DOCKGE_STACKS_DIR, PUID, PGID
Basic
  • Default Stacks Directory: /opt/stacks
  • Default Port: 5001
# Create directories that store your stacks and stores Dockge's stack
mkdir -p /opt/stacks /opt/dockge
cd /opt/dockge

# Download the compose.yaml
curl https://raw.githubusercontent.com/louislam/dockge/master/compose.yaml --output compose.yaml

# Start the server
docker compose up -d

# If you are using docker-compose V1 or Podman
# docker-compose up -d

Update with `docker compose pull && docker compose up -d` in /opt/dockge

How to configure dockge

  • DOCKGE_STACKS_DIR/opt/stacksTells Dockge where your stacks directory is; the host and container bind paths must match

    values: any absolute path

  • PUIDSets stack file/dir ownership to this user; both PUID and PGID must be set for it to do anything

    values: numeric user id (example uses 1000); default is root

  • PGIDSets stack file/dir ownership to this group; both PUID and PGID must be set for it to do anything

    values: numeric group id (example uses 1000)

  • port5001Query string used by the compose.yaml generator on the website to set the served port
  • stacksPath/opt/stacksQuery string used by the compose.yaml generator to set the stacks directory

dockge releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Can I install both Dockge and Portainer?

Yes, both can be installed together.

Is Dockge a Portainer replacement?

Partly: for compose-only management yes, but Portainer also covers things like networks and single containers, so Dockge does not replace it there.

Can I manage existing stacks?

Yes, after moving the compose file into the stacks directory as <stackName>/compose.yaml and using the Scan Stacks Folder action.

Can I manage a single container without compose.yaml?

No — Dockge is built around compose.yaml for everything, so for single containers it suggests the Docker CLI or Portainer.

What does the name Dockge mean?

It is a made-up word coined by the author, originally meant to sound like "Dodge", inspired by Twitch emotes ending in -ge.

More in Docker Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…