Guides & Documentation
Here you’ll find everything you need to use HDD-Housing as your offsite backup target: how to prepare your hard drives the same way as on our server, and how to connect common backup software to your storage.
If you don’t want to prefill your drives, you can also simply send us an empty HDD – we’ll set everything up for you.
Setup
- Proxmox VE – Prepare Proxmox VE like our server: enable the no-subscription repository, create the ZFS pool and set permissions for VersityGW and Syncthing.
- LXC container – Create an unprivileged Debian 13 LXC container in Proxmox and mount your ZFS pool for VersityGW and Syncthing.
- Debian/Ubuntu (without Proxmox) – Prefill your HDD-Housing ZFS pool without Proxmox: install ZFS on Debian or Ubuntu, create the pool and set the correct user IDs.
- Send an empty HDD – Don’t want to prefill? Send HDD-Housing an empty hard drive – we create the ZFS pool and services for you at no extra handling fee.
- ZFS pool – Create a ZFS pool for HDD-Housing with stable WWN or PARTUUID device names: mirror, RAIDZ1, single disk or single disk with redundant partitions.
- VersityGW (S3) – Install the S3-compatible VersityGW gateway on Debian, store objects as plain files on ZFS, manage S3 users and keep the gateway up to date.
- Syncthing – Use Syncthing as an offsite backup target at HDD-Housing: why ZFS snapshots make it ransomware-safe, and how to install it to prefill your pool.
- Troubleshooting – Fix common ZFS pool issues for HDD-Housing: switch an existing pool to WWN device names or rename it to your customer ID.
Backup software
- Restic – Back up Linux servers encrypted and deduplicated with Restic to S3 storage (VersityGW) at HDD-Housing: install, configure, initialise, back up.
- BorgBackup – Use BorgBackup 1.4 with HDD-Housing: Borg 1.4 has no S3 support, so back up to a local repository and sync it to S3 storage with rclone.
- Nextcloud – Back up a self-hosted Nextcloud to S3 storage at HDD-Housing: maintenance mode, database dump and data sync with rclone in one script.
- iCloud – Options for backing up iCloud Drive and iCloud Photos on a Mac, e.g. with Parachute or Carbon Copy Cloner, and transferring the backup to HDD-Housing.
Technical details
- ZFS snapshots – How HDD-Housing protects your backups against ransomware: ZFS snapshots of the whole pool with Sanoid, default retention and how to change it.
Something missing or unclear? Write to support@hdd-housing.at.