openspug/spug

By openspug

•Updated 7 days ago

Agentless ops platform: hosts, web terminal, deployments, pipelines, cron jobs, monitoring

Image

10K+

Overview Tags

openspug/spug repository overview

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 use Spug without maintaining the control panel yourself? Spug Cloud is being researched and is not available yet. The proposed service would host the control panel and connect to your servers over SSH, at a planned $4.9 per server/month. If you would consider trying it at that price, join the research waitlist⁠ and tell us how many servers you manage and what you would use it for. Self-hosted Spug remains free and open source.

⁠🔥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