EasyDockerWeb

A simple Web UI for Docker using xterm.js, Node.js and Socket.IO.

Features:

• Container management (create, start, stop, remove)
• Compose / Standalone container grouping with collapsible sections
• Interactive terminal (xterm.js)
• Real-time log viewer
• System overview dashboard
• Image search and pull
• Simple authentication

Tech Stack

Component	Version
Node.js	LTS
Express	4.x
Socket.IO	4.x
EJS	5.x
Dockerode	4.x
xterm.js	4.x

Quick Start

Method 1: Using build script (Recommended)

git clone https://github.com/qfdk/EasyDockerWeb.git
cd EasyDockerWeb
chmod +x build.sh
./build.sh

Method 2: Manual deployment

# Build the image
docker build -t easy-docker-web .

# Run the container
docker run -d \
  --name easy-docker-web \
  -p 3000:3000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  easy-docker-web

Access the web interface at http://localhost:3000

Default credentials: admin/admin

You can customize the username and password by setting environment variables:

docker run -d \
  --name easy-docker-web \
  -p 3000:3000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e EDW_USERNAME='your_username' \
  -e EDW_PASSWORD='your_password' \
  easy-docker-web

Requirements

• Docker Engine with Remote API >= v1.24
• Linux, macOS, or Windows with Docker installed

Development Mode

git clone https://github.com/qfdk/EasyDockerWeb.git
cd EasyDockerWeb
pnpm install
pnpm start

中文说明

简单的 Docker 管理工具，基于 Express + Socket.IO 实现前后端通讯。

功能特点：

• 容器管理（创建、启动、停止、删除）
• Compose / 独立容器分组显示，支持折叠
• 交互式终端（xterm.js）
• 实时日志查看
• 系统概览面板
• 镜像搜索和拉取
• 简单的身份验证

快速开始

方式一：使用构建脚本（推荐）

git clone https://github.com/qfdk/EasyDockerWeb.git
cd EasyDockerWeb
chmod +x build.sh
./build.sh

方式二：手动部署

# 构建镜像
docker build -t easy-docker-web .

# 运行容器
docker run -d \
  --name easy-docker-web \
  -p 3000:3000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  easy-docker-web

访问地址：http://localhost:3000

默认账号密码：admin/admin

Screenshots

Login

Overview Dashboard

Container Management

Create Container

Image Management

Pull Image (with autocomplete)

Interactive Terminal

Sponsor