openspug/spug

Spug is a lightweight agent-free automatic operation and maintenance platform designed for small and medium-sized enterprises. It integrates host management, host batch execution, host online terminal, file management, application release and deployment, pipelines, online task planning, configuration center, monitoring, alarm and so on.

JavaScript

11,082

1,268 commits

updated Oct 12, 2026

See the code

README

English | 简体中文

Spug

Spug is a lightweight agent-free automatic operation and maintenance platform designed for small and medium-sized enterprises. It integrates host management, host batch execution, host online terminal, file management, application release and deployment, pipelines, online task planning, configuration center, monitoring, alarm and so on.

Demo

Demo: https://demo.spug.cc (username admin, password spug.cc)

The demo environment runs the latest version and resets its data every hour, both the English and the Simplified Chinese interface are available from the globe icon in the header.

Quick start

You need Docker 20.10.10 or later with the Compose plugin. The image runs on amd64 and arm64 and has the back end and the web UI built in, so nothing is downloaded when the container starts.

curl -fsSLO https://raw.githubusercontent.com/openspug/spug/4.0/docker-compose.yml
docker compose up -d
docker compose logs spug | grep password

Open http://<your-server>/ and log in as admin with the password printed by the last command (it is generated on the first start). Time zone, port and database password are set in docker-compose.yml, and the image is also published as ghcr.io/openspug/spug. For a quick look without the database container, docker run -d --name spug -p 8080:80 openspug/spug:4.1 starts a single container on SQLite (get the password with docker logs spug | grep password). Upgrades and other ways to install are covered in the installation guide.

Would you rather not run it yourself? We are looking into Spug Cloud, a hosted version where we run the control panel and reach your servers over SSH with a separate key for each one, so there is still no agent to install. If that sounds useful, join the waitlist.

🔥Push Assistant

Push Assistant is a message push platform that integrates multiple channels such as telephone, SMS, email, Feishu, DingTalk, WeChat, and WeChat Work. It can realize telephone and SMS alarms of Zabbix, Prometheus, Nightingale and other monitoring systems in 3 minutes. Click to experience: https://push.spug.cc

Features

  • Host Management: Manage hosts by group, import them from cloud providers or an Excel file, and check connectivity in batch
  • Host Batch Execution: Support host batch online command execution, with parameterized commands, reusable templates and execution history
  • Host Online Terminal: The host supports browser online terminal login
  • Host File Management: Support host files online upload and download
  • File Distribution: Distribute files and directories from one host to many hosts
  • Build and Deploy: Support application custom build deployment, with review flow, canary release and rollback
  • Pipelines: Orchestrate parameter, build, remote command, data transfer, data upload and DingTalk / Feishu / WeChat Work / Push Assistant notification nodes into a workflow, with conditional branches and a live console
  • Task Planning: It supports online configuration of crontab, interval and other task schedules
  • Configuration Center: Support KV, text, json and other formats online configuration
  • Monitoring Center: Support site, port, process, ping, custom script and other monitoring
  • Alarm Center: Support email, WeChat, DingTalk, WeChat Work, Feishu and other alarm methods
  • Credential Management: Keep passwords and private keys in one place and share them across hosts
  • Permission Control: Fine-grained role and permission control, LDAP login and MFA are supported
  • Bilingual UI: Full English and Simplified Chinese interface, switchable from the header
  • Elegant and beautiful: UI interface based on Ant Design
  • Open source and free: The front-end and back-end code is completely open source

Environment

  • Python 3.8+
  • Django 4.2
  • Node.js 18+
  • React 16.13
  • Redis 5.0+

Documentation

PreView

Workbench

workbench

Dashboard

dashboard

Host Management

hosts

Host Online Terminal

web terminal

File Online Upload and Download

file manager

Host Batch Execution

batch execution batch execution output

Pipelines

Orchestrate build, command, data transfer, upload and notification nodes into a workflow.

pipeline editor built-in pipeline modules pipeline node config pipeline console

Application Release

deploy configuration deploy request deploy console

Task Planning

scheduled tasks

Configuration Center

configuration center

Monitoring and Alarm

monitoring alarm

AGPL-3.0

alert
ci
cicd
cmdb
deploy
devops
django-ops
jenkins
monitor
operations
ops
ops-admin
opsadmin
ops-tools
spug
task
webconsole
webshell
webssh

openspug/spug

Spug is a lightweight agent-free automatic operation and maintenance platform designed for small and medium-sized enterprises. It integrates host management, host batch execution, host online terminal, file management, application release and deployment, pipelines, online task planning, configuration center, monitoring, alarm and so on.

JavaScript

11,082

1,268 commits

updated Oct 12, 2026

See the code

README

English | 简体中文

Spug

Spug is a lightweight agent-free automatic operation and maintenance platform designed for small and medium-sized enterprises. It integrates host management, host batch execution, host online terminal, file management, application release and deployment, pipelines, online task planning, configuration center, monitoring, alarm and so on.

Demo

Demo: https://demo.spug.cc (username admin, password spug.cc)

The demo environment runs the latest version and resets its data every hour, both the English and the Simplified Chinese interface are available from the globe icon in the header.

Quick start

You need Docker 20.10.10 or later with the Compose plugin. The image runs on amd64 and arm64 and has the back end and the web UI built in, so nothing is downloaded when the container starts.

curl -fsSLO https://raw.githubusercontent.com/openspug/spug/4.0/docker-compose.yml
docker compose up -d
docker compose logs spug | grep password

Open http://<your-server>/ and log in as admin with the password printed by the last command (it is generated on the first start). Time zone, port and database password are set in docker-compose.yml, and the image is also published as ghcr.io/openspug/spug. For a quick look without the database container, docker run -d --name spug -p 8080:80 openspug/spug:4.1 starts a single container on SQLite (get the password with docker logs spug | grep password). Upgrades and other ways to install are covered in the installation guide.

Would you rather not run it yourself? We are looking into Spug Cloud, a hosted version where we run the control panel and reach your servers over SSH with a separate key for each one, so there is still no agent to install. If that sounds useful, join the waitlist.

🔥Push Assistant

Push Assistant is a message push platform that integrates multiple channels such as telephone, SMS, email, Feishu, DingTalk, WeChat, and WeChat Work. It can realize telephone and SMS alarms of Zabbix, Prometheus, Nightingale and other monitoring systems in 3 minutes. Click to experience: https://push.spug.cc

Features

  • Host Management: Manage hosts by group, import them from cloud providers or an Excel file, and check connectivity in batch
  • Host Batch Execution: Support host batch online command execution, with parameterized commands, reusable templates and execution history
  • Host Online Terminal: The host supports browser online terminal login
  • Host File Management: Support host files online upload and download
  • File Distribution: Distribute files and directories from one host to many hosts
  • Build and Deploy: Support application custom build deployment, with review flow, canary release and rollback
  • Pipelines: Orchestrate parameter, build, remote command, data transfer, data upload and DingTalk / Feishu / WeChat Work / Push Assistant notification nodes into a workflow, with conditional branches and a live console
  • Task Planning: It supports online configuration of crontab, interval and other task schedules
  • Configuration Center: Support KV, text, json and other formats online configuration
  • Monitoring Center: Support site, port, process, ping, custom script and other monitoring
  • Alarm Center: Support email, WeChat, DingTalk, WeChat Work, Feishu and other alarm methods
  • Credential Management: Keep passwords and private keys in one place and share them across hosts
  • Permission Control: Fine-grained role and permission control, LDAP login and MFA are supported
  • Bilingual UI: Full English and Simplified Chinese interface, switchable from the header
  • Elegant and beautiful: UI interface based on Ant Design
  • Open source and free: The front-end and back-end code is completely open source

Environment

  • Python 3.8+
  • Django 4.2
  • Node.js 18+
  • React 16.13
  • Redis 5.0+

Documentation

PreView

Workbench

workbench

Dashboard

dashboard

Host Management

hosts

Host Online Terminal

web terminal

File Online Upload and Download

file manager

Host Batch Execution

batch execution batch execution output

Pipelines

Orchestrate build, command, data transfer, upload and notification nodes into a workflow.

pipeline editor built-in pipeline modules pipeline node config pipeline console

Application Release

deploy configuration deploy request deploy console

Task Planning

scheduled tasks

Configuration Center

configuration center

Monitoring and Alarm

monitoring alarm

AGPL-3.0

alert
ci
cicd
cmdb
deploy
devops
django-ops
jenkins
monitor
operations
ops
ops-admin
opsadmin
ops-tools
spug
task
webconsole
webshell
webssh

Project health

Overall

4.1/10

Maintained

10/10

Code review

0/10
OpenSSF Scorecard

Significant stargazers

Gong Dewei

60 followers · starred Dec 2021

xgdgsc

191 followers · starred May 2025

Mason Huang

57 followers · starred Mar 2019

Mmx233

75 followers · starred Jul 2020