A lightweight Go server that exposes HTTP webhook endpoints which run configured shell commands, passing request data as arguments or environment variables.
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
Download the docker-compose.yml file
curl -fsSLO https://raw.githubusercontent.com/openspug/spug/4.0/docker-compose.yml - 2
Start the containers in the background
docker compose up -d - 3
Get the generated admin password from the logs
docker compose logs spug | grep password - 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
A self-hosted CI/CD engine that runs pipelines defined in config files in containers, with extensibility through plugins.
Self-hostable deployment platform for web apps, offering git-push deploys, preview URLs, custom domains, Postgres, auth and a mailer on your own server.
Self-hosted CI/CD and DevOps automation platform in Go, built around workflows chained from pipelines, jobs and triggers.
Self-hosted Docker dashboard for container logs, metrics, events, alert rules, notifications and guarded auto-remediation.
Enterprise configuration management platform for assets and applications, covering hosts, processes, business topology and custom models.