1. Central Server Setup

The central server coordinates probing requests, aggregates metrics from remote agents, executes alerts, and serves public status views.

🐳

Docker Compose (Recommended)

Ideal for secure, production-ready deploy on a VPS.

version: '3.8'
services:
  bloodkings:
    image: bkpepe/bloodkings:latest
    ports:
      - "8080:80"
    volumes:
      - ./data:/var/www/html/data
    environment:
      - DB_PASSWORD=your_secure_password
    restart: always

1. Save the above snippet into a file named docker-compose.yml

2. Spin up the container daemon: docker compose up -d

3. Navigate in browser to: http://localhost:8080

🐘

Classic Web Hosting (LAMP)

Run without Docker on standard PHP shared hosts or Apache configurations.

System Requirements:

  • PHP 8.2 or higher
  • MySQL/MariaDB or SQLite database support
  • Apache mod_rewrite enabled (with .htaccess)
πŸ“₯ Download Source ZIP Archive

After uploading files via FTP, open the site domain and the setup page will guide you through database connection details.

2. Remote Telemetry Agents

To measure internal OS statistics (CPU usage, RAM space, local disk logs) or localized ping latency, deploy remote agents.

1-Step Installation

Install Agent in 10 Seconds

Choose your platform and copy the installation script. The agent automatically detects the target OS and runs.

Agent Version:v0.1.0-alpha

A simple Bash script downloads the binary file, registers the systemd daemon, and starts the background task.

curl -fsSL https://monitoring.bloodkings.eu/install.sh | sh -s -- --token YOUR_SECRET_TOKEN
Agent Version:v0.1.0-alpha

The PowerShell command registers a Windows Service, writes registry keys, and runs the monitoring thread.

irm https://monitoring.bloodkings.eu/install.ps1 | iex; install-agent -Token "YOUR_SECRET_TOKEN"
Docker Tag:latest

Insert the monitoring agent service definition inside your docker-compose file. Runs isolated.

version: '3.8'
services:
  bloodkings-agent:
    image: bkpepe/bloodkings-agent:v0.1.0-alpha
    restart: always
    environment:
      - SERVER_URL=https://monitoring.bloodkings.eu
      - AGENT_TOKEN=YOUR_SECRET_TOKEN
Agent Version:v0.1.0-alpha

Optimized for low CPU and memory footprints on ARMv7/ARM64 single-board systems.

curl -fsSL https://monitoring.bloodkings.eu/install.sh | sh -s -- --arch arm64 --token YOUR_SECRET_TOKEN

Want to contribute?

The Blood Kings Monitoring system is 100% open-source, licensed under the MIT License. Contributions, documentation guides, and issue reports are welcome on GitHub.