UniFi Backup

A Golang application to automatically backup your UniFi network controller configuration on UniFi OS. Supports local filesystem, SMB/CIFS shares, S3, and Google Cloud Storage.

Use SMB to back up directly to a UniFi NAS or any network share.

See CONFIGURATION.md for setup details.

A Docker image is available at ghcr.io/connorsapps/unifi-backup:latest

Quick Start

# Set credentials
export UNIFI_URL=https://your-unifi-controller
export UNIFI_USER=admin
export UNIFI_PASS=your-password

# Run (backups save to ./backups by default)
go run github.com/ConnorsApps/unifi-backup

# Or use a config file
go run github.com/ConnorsApps/unifi-backup -config config.yaml

# Run with docker
docker run --rm \
  -e UNIFI_URL=https://your-unifi-controller \
  -e UNIFI_USER=admin \
  -e UNIFI_PASS=your-password \
  -v $(pwd)/backups:/backups \
  ghcr.io/connorsapps/unifi-backup:latest

Requirements

• UniFi OS console running UniFi Network
• Local UniFi OS user with Administrator role for UniFi Network