Skip to main content

Installation Overview

Setting up Tergum involves configuring two servers (master and slave) to work together with real-time replication and automatic failover.

Setup Process

The Initial Setup Wizard in the Tergum dashboard guides you through these steps:

1. Prerequisites Check

Verify you have everything needed:

  • Two servers with Ubuntu 20.04+ or Debian 11+
  • Root SSH access to both
  • WordPress installed on the master server
  • Cloudflare and Tailscale accounts

2. Tailscale Configuration

Install Tailscale on both servers for secure networking:

  • Creates encrypted tunnel between servers
  • Works through NAT and firewalls
  • No port forwarding required

3. Agent Installation

Run installer scripts on both servers:

  • Master: Configures MySQL for replication, installs Tergum agent
  • Slave: Installs matching software stack, configures as replica, sets up Cloudflare Tunnel

4. WordPress Clone

Copy your WordPress site from master to slave:

  • Database dump and restore
  • File transfer via rsync
  • Automatic replication setup

5. Domain Configuration

Add your domains and configure failover:

  • Connect Cloudflare for DNS management
  • Set failover policies
  • Configure email alerts

Time Estimate

StepTime
Prerequisites gathering10-15 min
Tailscale setup5-10 min
Agent installation10-15 min
WordPress clone5-30 min (depends on site size)
Domain configuration5-10 min
Total35-80 minutes

What You'll Need

Accounts

Server Access

  • Root SSH access to both servers
  • Ability to install packages (apt/yum)

Information to Have Ready

  • Master server hostname or IP
  • Slave server hostname or IP
  • WordPress database credentials (if not using root)
  • Cloudflare API token (created during setup)

Next Steps

  1. Check system requirements →
  2. Set up your master server →
  3. Set up your slave server →