HDD-Housing e.U.

Back up Nextcloud to S3 storage with rclone

This guide backs up a self-hosted Nextcloud – data, configuration and database – to the S3 storage on your HDD-Housing drive using rclone.

1. Configure rclone

Install rclone and add a remote to ~/.config/rclone/rclone.conf (alternatively use rclone config):

[hddhousing]
type = s3
provider = Other
access_key_id = access_key
secret_access_key = secret_key
endpoint = http://IP-OR-DNS:7070

Replace access_key, secret_key and IP-OR-DNS with the values you receive with your account.

2. Backup script

A consistent backup requires a database dump before the transfer. Create backup.sh:

#!/bin/bash
# 1. Put Nextcloud into maintenance mode
sudo -u www-data php /var/www/nextcloud/occ maintenance:mode --on

# 2. Dump the database (example for MariaDB)
mysqldump --single-transaction -u db_user -pdb_password db_name > /tmp/nextcloud-db.sql

# 3. Sync to S3 (data + config + database dump)
rclone sync /var/www/nextcloud/data hddhousing:bucket/data/
rclone sync /var/www/nextcloud/config hddhousing:bucket/config/
rclone copy /tmp/nextcloud-db.sql hddhousing:bucket/database/
rm /tmp/nextcloud-db.sql

# 4. Turn off maintenance mode
sudo -u www-data php /var/www/nextcloud/occ maintenance:mode --off

rclone sync mirrors deletions as well. Older states remain available on our side through the ZFS snapshots.