louislam/dockge
Fork: 39 Star: 1479 (更新于 1970-01-01 00:00:00)
license: MIT
Language: TypeScript .
A fancy, easy-to-use and reactive self-hosted docker compose.yaml stack-oriented manager
最后发布版本: 1.1.0 ( 2023-11-19 17:46:58)
Dockge
A fancy, easy-to-use and reactive self-hosted docker compose.yaml stack-oriented manager.
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 intocompose.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
- Dockge won't kidnap your compose files, they are stored on your drive as usual. You can interact with them using normal
🔧 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 EXAMPLE: - /my-stacks:/my-stacks (Both paths match)
# ❌❌❌❌ WRONG EXAMPLE: - /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:
- Stop your stack
- Move your compose file into
/opt/stacks/<stackName>/compose.yaml
- In Dockge, click the " Scan Stacks Folder" button in the top-right corner's dropdown menu
- 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
.
最近版本更新:(数据更新于 1970-01-01 00:00:00)
2023-11-19 17:46:58 1.1.0
2023-11-17 01:05:45 1.0.4
2023-11-13 20:46:05 1.0.3
2023-11-12 16:50:52 1.0.1
2023-11-12 02:06:41 1.0.0
主题(topics):
docker, docker-compose, docker-deployment, docker-stack, docker-stack-deploy, docker-ui, responsive, self-hosted, selfhosted, single-page-app, socket-io, webapp, websocket
louislam/dockge同语言 TypeScript最近更新仓库
2024-11-05 17:55:23 langgenius/dify
2024-11-05 17:35:52 siyuan-note/siyuan
2024-11-05 16:59:32 laurent22/joplin
2024-11-05 12:39:27 lobehub/lobe-chat
2024-11-05 11:52:31 RSSNext/Follow
2024-11-05 07:18:03 microsoft/genaiscript