# BFBackup Controller

BFBackup Controller is the management container for BFBackup, a Docker-based backup tool that copies folders as plain files with no repository or archive format. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7539/bfbackup-controller

## Description

BFBackup Controller is the management container for BFBackup, a Docker-based backup tool that copies folders as plain files with no repository or archive format. It provides the web UI and schedules, backing up folders incrementally and fast over the LAN to other servers (each running a bfbackup-peer container), to local disks, or to USB drives. Backups are ordinary files and folders on the target, so you can open and copy them without BFBackup. For remote targets, run one bfbackup-peer container on the destination server; it connects to the controller on port 7701 using a token you create in the web UI. Made for Unraid, works on any Linux Docker host.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

42/100 (Fair), based on 3 of 4 factors.
- Maintained: 72 (last commit 14 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/app_42ab0bb9b98f41b4
- GitHub: https://github.com/delsol-ger/bfbackup

## Common questions

### Do remote servers need inbound ports opened for BFBackup peers?

No. Peers connect to the controller on port 7701 using the token, so the peer side needs no open ports.

### How do I tell BFBackup which host folders it may use?

Mount the host paths into the container and set BFB_ROOTS to the folders BFBackup may access, defaulting to /mnt.

### How should I set ownership for backup files on Unraid?

Set BFB_UID and BFB_GID to the owner of written files; on Unraid this is typically 99/100.

### Where is the controller database and configuration stored?

It is stored in BFB_DATA, which defaults to /config inside the container.

### Will file deletion on one node automatically delete the backup on another?

Deletes never propagate on their own, and removed files go to a trash first.

---
Source: Our Local Host (https://ourlocalhost.com/app/7539/bfbackup-controller), the self-hosted and open-source app directory.
