Repolode
openspug

openspug/spug

Lightweight agent-free ops platform for small and medium businesses covering host management, batch commands, web SSH, releases, pipelines and monitoring.

Open-source alternative to:Jenkins

Stars
11,101
Forks
2,198
Open issues
9
Last commit
3 days ago

What is it?

Spug is an operations platform for small and medium-sized teams that manages servers without installing an agent on each host. It groups hosts, imports them from cloud providers or Excel files, and checks connectivity in batch. From the browser you can run commands across many hosts, open a web terminal, and upload or download files.

For delivery, Spug supports custom build and deployment with review flow, canary release and rollback, plus file distribution from one host to many. Pipelines chain parameter, build, remote command, data transfer and notification nodes into a workflow with conditional branches. Other modules include scheduled tasks, a key-value and text configuration center, site, port, process and script monitoring, and alarms through email, WeChat, DingTalk, WeChat Work and Feishu.

Spug is deployed with Docker Compose and offers a bilingual English and Simplified Chinese interface. Its stack is Django on the back end and React on the front end, with Redis required.

Key features

  • 01Agentless host management with batch connectivity checks and batch command execution.
  • 02Browser-based web terminal and online file upload and download.
  • 03Application build, deployment, canary release and rollback with review flow.
  • 04Visual pipelines with conditional branches and a live console.
  • 05Scheduled tasks, configuration center and site, port, process and script monitoring.
  • 06Alarm delivery via email, WeChat, DingTalk, WeChat Work and Feishu.

Use cases

  • Managing a fleet of servers for a small or medium-sized company without deploying agents.
  • Running routine commands or distributing config files to many hosts at once.
  • Automating application releases with approvals, canary rollout and rollback.
  • Centralizing monitoring alerts and scheduled maintenance jobs for an ops team.

Quick start

  1. 1

    Download the docker-compose.yml file

    curl -fsSLO https://raw.githubusercontent.com/openspug/spug/4.0/docker-compose.yml
  2. 2

    Start the containers in the background

    docker compose up -d
  3. 3

    Get the generated admin password from the logs

    docker compose logs spug | grep password
  4. 4

    Open the server address in a browser and log in as admin

Things to know

  • Licensed under AGPL-3.0, a copyleft license that requires sharing modified source code when offered over a network.
  • Requires Docker 20.10.10 or later with the Compose plugin to run the standard setup.
  • Self-hosting means you install, upgrade and maintain the control panel yourself.

In collections

Topics

FAQ

What is spug?
Lightweight agent-free ops platform for small and medium businesses covering host management, batch commands, web SSH, releases, pipelines and monitoring. Spug is an operations platform for small and medium-sized teams that manages servers without installing an agent on each host. It groups hosts, imports them from cloud providers or Excel files, and checks connectivity in batch. From the browser you can run commands across many hosts, open a web terminal, and upload or download files.
Is spug free to use? What license does it have?
spug is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is spug still maintained?
Actively maintained. The last commit to spug was on Nov 4, 2026.
What can I use spug for?
Managing a fleet of servers for a small or medium-sized company without deploying agents. Running routine commands or distributing config files to many hosts at once. Automating application releases with approvals, canary rollout and rollback. Centralizing monitoring alerts and scheduled maintenance jobs for an ops team.
How do I install spug?
Download the docker-compose.yml file: curl -fsSLO https://raw.githubusercontent.com/openspug/spug/4.0/docker-compose.yml Start the containers in the background: docker compose up -d Get the generated admin password from the logs: docker compose logs spug | grep password Open the server address in a browser and log in as admin
Where can I get spug?
The source code and installation instructions are on GitHub: https://github.com/openspug/spug

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects