explaingit

awuqing/backupx

97GoAudience · ops devopsComplexity · 3/5ActiveLicenseSetup · easy

TLDR

Self-hosted Go tool that runs file and database backups across many servers from one web console, shipping as a single binary with embedded SQLite and over seventy storage backends.

Mindmap

mindmap
  root((BackupX))
    Inputs
      Files and directories
      Database connections
      Cron schedules
    Outputs
      Remote backup files
      Audit logs
      Prometheus metrics
    Use Cases
      Schedule cross server backups
      Back up MySQL or HANA
      Forward audit events to a SIEM
    Tech Stack
      Go
      SQLite
      React
      Vite
      Docker
      rclone

Things people build with this

USE CASE 1

Self host a backup console that manages many servers from one browser tab

USE CASE 2

Schedule MySQL or PostgreSQL dumps with retention by day count or copy count

USE CASE 3

Route SAP HANA Backint backups straight into S3 or WebDAV

USE CASE 4

Forward HMAC signed audit events to a SIEM for SOC2 or GDPR evidence

Tech stack

GoSQLiteReactDockerrclone

Getting it running

Difficulty · easy Time to first run · 30min

Single binary with embedded SQLite, easiest via Docker on port 8340, but configuring storage backends and database credentials adds time.

Apache 2.0 license, free to use, modify, and redistribute including for commercial work, with attribution and a patent grant.

In plain English

BackupX is a self-hosted tool for managing backups across one or many servers from a single web console. It is built in Go, ships as one binary with an embedded SQLite database, and stores its own state with no external services. The author pitches it as one command and one binary that lets you set up file and database backups, send them off to remote storage, and monitor the results from a browser. The tool supports several kinds of backup jobs. It can copy files and directories from one or more source locations. It can dump databases including MySQL, PostgreSQL, SQLite, and SAP HANA, with the database backups offering full, incremental, differential, and log modes, parallel data channels, and retry behavior. For SAP HANA in particular, BackupX ships a built-in Backint agent so that HANA's native backup interface can route data directly to any storage backend the tool supports. The storage side is broad. The README lists more than seventy backends, including Alibaba OSS, Tencent COS, Qiniu, generic S3, Google Drive, WebDAV, FTP, SFTP, Azure Blob, Dropbox, and OneDrive, with many more available through rclone. Scheduling is done with cron expressions backed by a visual editor, and retention rules can be set by number of days or number of copies, with an option to clean up empty directories. A multi-node mode lets a central Master coordinate Agents on other servers using HTTP long-polling, so the Agents pull work without needing inbound connections opened to them, and they upload straight to the chosen storage backend. Security and monitoring features fill out the rest of the table. Authentication uses JWT and bcrypt, configuration is encrypted with AES-256-GCM, individual backups can be encrypted, and a full audit log is recorded. Notifications go out by email, webhook, or Telegram. A Prometheus metrics endpoint and health and readiness probes are exposed, and an HMAC-signed audit webhook can forward events to a SIEM or write-once storage for SOC2 or GDPR compliance. Deployment is meant to be simple. The recommended path is a Docker container that maps port 8340 and a data volume. There is also a prebuilt archive for Linux on amd64 and arm64 that you extract and install with a shell script. Developers can run the Go backend and the Vite-powered React frontend separately with make commands, and there is a full documentation site linked from the README. The license is Apache 2.0.

Copy-paste prompts

Prompt 1
Walk me through running BackupX in Docker on port 8340 with a persistent data volume
Prompt 2
Show me how to set up a daily PostgreSQL backup in BackupX that lands in S3 with 14 day retention
Prompt 3
Explain BackupX's Master and Agent long polling model and what ports each node needs open
Prompt 4
Help me wire BackupX notifications to Telegram and configure the Prometheus metrics endpoint
Prompt 5
Sketch a SAP HANA backup job using BackupX's built in Backint agent with parallel data channels
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.