Spug: Lightweight Agentless Automation Platform with Docker Deployment Guide

Spug is a lightweight, agentless automation platform designed for small and medium enterprises, integrating host management, batch command execution, online terminal access, application publishing and deployment, task scheduling, configuration center, monitoring, and alerting.

Features

Batch Execution: Online batch execution of host commands.

Online Terminal: Browser‑based terminal login for hosts.

File Management: Online upload and download of host files.

Task Scheduling: Flexible online task scheduler.

Publishing & Deployment: Customizable release workflow.

Configuration Center: Supports KV, text, JSON formats.

Monitoring Center: Supports site, port, process, and custom monitoring.

Alert Center: Supports SMS, email, DingTalk, WeChat alerts.

Elegant UI: UI built with Ant Design.

Open Source & Free: Front‑end and back‑end code fully open source.

Docker Installation

Install Docker

Note: If Docker is already installed, skip this step. The following commands are for CentOS; refer to the official Docker documentation for other systems.

yum install -y yum-utils
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yum install docker-ce docker-compose-plugin
systemctl enable docker
systemctl start docker

Create docker‑compose.yml

vi docker-compose.yml

version: "3.3"
services:
  db:
    image: mariadb:10.8.2
    container_name: spug-db
    restart: always
    command: --port 3306 --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
    volumes:
      - /data/spug/mysql:/var/lib/mysql
    environment:
      - MYSQL_DATABASE=spug
      - MYSQL_USER=spug
      - MYSQL_PASSWORD=spug.cc
      - MYSQL_ROOT_PASSWORD=spug.cc
  spug:
    image: openspug/spug-service
    container_name: spug
    privileged: true
    restart: always
    volumes:
      - /data/spug/service:/data/spug
      - /data/spug/repos:/data/repos
    ports:
      # If port 80 is occupied, replace with another, e.g., "8000:80"
      - "80:80"
    environment:
      - MYSQL_DATABASE=spug
      - MYSQL_USER=spug
      - MYSQL_PASSWORD=spug.cc
      - MYSQL_HOST=db
      - MYSQL_PORT=3306
    depends_on:
      - db

Start Containers

docker compose up -d

Note: Depending on your docker‑compose installation method, you may need to run docker-compose up -d instead.

Initialize docker exec spug init_spug admin spug.dev Access Test

Open a browser and navigate to http://localhost:80 to access the Spug UI.

Open Source Repository

https://github.com/openspug/spug