Licensing | XMigrate Docs

Overview

The backup server requires a valid license to operate. Agents do not require a license — they are managed by the server.

Validation: Checked at startup and every 24 hours
Expired license: Blocks new backups, but restore operations continue to work

Contact [email protected] or your vendor to obtain a license file.


sudo cp license.json /var/lib/backup/repo/license.json
sudo systemctl restart backup-server

Edit the systemd service file:


sudo nano /etc/systemd/system/backup-server.service


ExecStart=/usr/local/bin/xreplicator server \
  --listen 0.0.0.0:50051 \
  --repo /var/lib/backup/repo \
  --license /etc/xreplicator/license.json


sudo systemctl daemon-reload
sudo systemctl restart backup-server


export LICENSE_FILE="/etc/xreplicator/license.json"
sudo systemctl restart backup-server

License files are JSON:


{
  "data": "base64-encoded-json-payload",
  "signature": "base64-encoded-rsa-signature"
}

The license enforces a maximum number of connected agents. When the limit is reached, new agent registrations are rejected with:


license limit exceeded: X/Y agents connected

Disconnect unused agents or contact your vendor to upgrade the license.


sudo journalctl -u backup-server -f

Look for messages like:


# Valid
License validated: <org> (expires: <date>, VMs: <count>)

# Expired
WARN: License expired on <date>

The public key must be embedded in the binary at build time, or set via:


export LICENSE_PUBLIC_KEY="<key>"

Ensure the license file exists at the expected path, or use the --license flag to specify its location.

The license must be generated for the exact server hostname. Verify with:


hostname

Generate a new license with a future expiry date.

The maximum agent count has been reached. Disconnect unused agents or upgrade the license.