A fancy, easy-to-use and reactive self-hosted docker compose.yaml stack-oriented manager
Go to file
2023-11-26 17:29:53 +08:00
.github Add step to build the app aswell (#158) 2023-11-23 08:49:34 +08:00
backend Avoid multiple commands at the same for a stack 2023-11-26 17:29:53 +08:00
docker Downgrade from Node.js 20 to Node.js 18.17.1 2023-11-26 17:28:29 +08:00
extra Add @actions/github 2023-11-22 01:12:54 +08:00
frontend Enable back socket.io polling 2023-11-26 17:28:53 +08:00
.dockerignore Init (#1) 2023-11-11 22:18:37 +08:00
.editorconfig Init (#1) 2023-11-11 22:18:37 +08:00
.eslintrc.cjs ESLint, update vite to 5.0.0 and other dependencies (#63) 2023-11-18 13:59:40 +08:00
.gitignore Init (#1) 2023-11-11 22:18:37 +08:00
compose.yaml Update compose.yaml 2023-11-13 23:32:37 +08:00
CONTRIBUTING.md Add workflows, templates and docs (#134) 2023-11-22 00:55:34 +08:00
LICENSE Init (#1) 2023-11-11 22:18:37 +08:00
package.json Downgrade from Node.js 20 to Node.js 18.17.1 2023-11-26 17:28:29 +08:00
pnpm-lock.yaml Add @actions/github 2023-11-22 01:12:54 +08:00
README.md Update README.md 2023-11-23 11:03:20 +08:00
SECURITY.md Add workflows, templates and docs (#134) 2023-11-22 00:55:34 +08:00
tsconfig.json Add workflows, templates and docs (#134) 2023-11-22 00:55:34 +08:00

Dockge

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

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

View Video: https://youtu.be/AWAlOQeNpgU?t=48

Features

  • Manage compose.yaml
    • Create/Edit/Start/Stop/Restart/Delete
    • Update Docker Images
  • Interactive Editor for compose.yaml
  • Interactive Web Terminal
  • Reactive
    • Everything is just responsive. Progress (Pull/Up/Down) and terminal output are in real-time
  • Easy-to-use & fancy UI
    • If you love Uptime Kuma's UI/UX, you will love this one too
  • Convert docker run ... commands into compose.yaml
  • File based structure
    • Dockge won't kidnap your compose files, they are stored on your drive as usual. You can interact with them using normal docker compose commands

🔧 How to Install

Requirements:

  • Docker CE 20+ is recommended / Podman
  • (Docker only) Docker Compose Plugin
  • (Podman only) podman-docker (Debian: apt install podman-docker)
  • OS:
    • As long as you can run Docker CE / Podman, it should be fine, but:
    • Debian/Raspbian Buster or lower is not supported, please upgrade to Bullseye or higher
  • Arch: armv7, arm64, amd64 (a.k.a x86_64)

Basic

  • Default Stacks Directory: /opt/stacks
  • Default Port: 5001
# Create a directory that stores your stacks and stores dockge's compose.yaml
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

Dockge is now running on http://localhost:5001

Advanced

If you want to store your stacks in another directory, you can change the DOCKGE_STACKS_DIR environment variable and volumes.

version: "3.8"
services:
  dockge:
    image: louislam/dockge:1
    restart: unless-stopped
    ports:
      # Host Port : Container Port
      - 5001:5001
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./data:/app/data
        
      # If you want to use private registries, you need to share the auth file with Dockge:
      # - /root/.docker/:/root/.docker

      # Your stacks directory in the host (The paths inside container must be the same as the host)
      # ⚠️⚠️ If you did it wrong, your data could end up be written into a wrong path.
      # ✔️✔️✔️✔️ CORRECT: - /my-stacks:/my-stacks (Both paths match)
      # ❌❌❌❌ WRONG: - /docker:/my-stacks (Both paths do not match)
      - /opt/stacks:/opt/stacks
    environment:
      # Tell Dockge where is your stacks directory
      - DOCKGE_STACKS_DIR=/opt/stacks

How to Update

cd /opt/dockge
docker compose pull
docker compose up -d

Screenshots

Motivations

  • I have been using Portainer for some time, but for the stack management, I am sometimes not satisfied with it. For example, sometimes when I try to deploy a stack, the loading icon keeps spinning for a few minutes without progress. And sometimes error messages are not clear.
  • Try to develop with ES Module + TypeScript (Originally, I planned to use Deno or Bun.js, but they don't have support for arm64, so I stepped back to Node.js)

If you love this project, please consider giving it a .

🗣️

Bug Report

https://github.com/louislam/dockge/issues

Ask for Help / Discussions

https://github.com/louislam/dockge/discussions

Translation

If you want to translate Dockge into your language, please read Translation Guide

FAQ

"Dockge"?

"Dockge" is a coinage word which is created by myself. I hope it sounds like Dodge.

The naming idea came from Twitch emotes like sadge, bedge or wokege. They all end in -ge.

Can I manage a single container without compose.yaml?

The main objective of Dockge is to try to use the docker compose.yaml for everything. If you want to manage a single container, you can just use Portainer or Docker CLI.

Can I manage existing stacks?

Yes, you can. However, you need to move your compose file into the stacks directory:

  1. Stop your stack
  2. Move your compose file into /opt/stacks/<stackName>/compose.yaml
  3. In Dockge, click the " Scan Stacks Folder" button in the top-right corner's dropdown menu
  4. Now you should see your stack in the list

More Ideas?

  • Stats
  • File manager
  • App store for yaml templates
  • Get app icons
  • Switch Docker context
  • Support Dockerfile and build
  • Support Docker swarm

Others

Dockge is built on top of Compose V2. compose.yaml also known as docker-compose.yml.