mfrankovic/docker-backup repository overview

⁠Docker Backup

An always-on container that backs up your other Docker containers — their volumes, databases, and compose files — all from a simple web page: run backups by hand, schedule automatic ones, and restore.

• One folder holds everything. Point the tool at a backup folder; after any reinstall, point it at the same folder and every old backup is found again.
• Notices new containers on its own — nothing to set up when you add one.
• Backs up stopped containers too (their data is still saved).

⁠Docs

• Install from source⁠ — beginner-friendly, step by step.
• Using the web page⁠ — the tabs, and what gets backed up.
• Restoring & disaster recovery⁠ — roll back or rebuild from zero.

⁠Quick start (Docker Hub)

The image is published on Docker Hub, so you don't have to build anything. Pick a folder for your backups, then run:

docker run -d --name docker-backup --restart unless-stopped \
  -p 127.0.0.1:8088:8088 \
  -e BACKUP_ROOT_CONTAINER=/backups \
  -e BACKUP_ROOT_HOST=/srv/docker-backups \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /srv/docker-backups:/backups \
  mfrankovic/docker-backup:latest

Then open http://127.0.0.1:8088⁠.

Prefer Compose? Use this compose.yaml (pulls the image instead of building):

services:
  docker-backup:
    image: mfrankovic/docker-backup:latest
    container_name: docker-backup
    restart: unless-stopped
    environment:
      TZ: ${TZ:-UTC}
      BACKUP_ROOT_CONTAINER: /backups
      BACKUP_ROOT_HOST: ${BACKUP_ROOT_HOST}
      GUI_PORT: ${GUI_PORT:-8088}
    ports:
      - "127.0.0.1:${GUI_PORT:-8088}:${GUI_PORT:-8088}"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - "${BACKUP_ROOT_HOST}:/backups"

Available tags: latest, plus versioned tags like 1.0.0 and 1.0. The image is multi-arch (linux/amd64 and linux/arm64), so it runs on regular servers and on ARM boards (Raspberry Pi, ARM NAS) alike.

To build from source instead (handy if you want to modify it), see docs/INSTALL.md⁠.

⁠Settings reference (.env)

Your .env file is never uploaded to GitHub, so your settings stay private.

⁠License

MIT⁠.