Backup server setup

This guide shows how to set up a backup server for Quollix. For production use, this can serve as the external backup system in the 3-2-1 backup strategy.

There are two setup options:

• local storage for testing
• external storage for production

Local Testing

1. Start Quollix.
2. Create this docker-compose.yml:

services:
  ssh-server:
    image: linuxserver/openssh-server:latest
    container_name: dummy_backup_server
    environment:
      - PASSWORD_ACCESS=true
      - USER_NAME=sshadmin
      - USER_PASSWORD=sshpassword
    ports:
      - "127.0.0.1:2222:2222"
    networks:
      - quollix_postgres

networks:
  quollix_postgres:
    external: true

1. Start the backup server:

docker compose up -d

Use these values on the Quollix Settings -> Backup server page:

Then follow the remaining steps on the Remote Backup settings page.

External Storage

This example uses Hetzner Storage Box. Quollix is not affiliated with or sponsored by Hetzner.

1. Create a Hetzner account.
2. Open the Hetzner Cloud Console.
3. Create a project.
4. Open Storage -> Storage Boxes.
5. Create a Storage Box.
6. In Access, add your public SSH key and define a password.
7. Click Create & Buy now.
8. Wait until the Storage Box has been created.
9. Open the three-dot menu and select Change settings.
10. Enable SSH Support and External Reachability.
11. Save the settings.
12. Open the new Storage Box and copy its host and user values.

Use these values on the Quollix Settings -> Backup server page:

The SSH port we need on the Hetzner Storage Box is explicitly 23, not 22.

Then follow the remaining steps on the Remote Backup settings page.

Automatic Snapshots

In the Hetzner Console, open the Storage Box, go to Snapshots, and enable automatic snapshots.

These snapshots add a recovery path for worst-case incidents. If a compromised Quollix server is used to delete both the server data and the Storage Box data, the provider-managed snapshots can restore the Storage Box. After that, configure the same backup server on a clean Quollix server and restore the app backups.