Borgitory

Borgitory is a comprehensive web-based management interface for BorgBackup repositories that provides real-time monitoring, automated scheduling, and cloud synchronization capabilities. It offers complete backup lifecycle management including on-demand backups, automated pruning policies, interactive archive browsing with file downloads, and cloud sync to S3-compatible storage via Rclone. The FastAPI powered system features a modern responsive web interface built with HTMX, and Tailwind CSS.

Quick Start

full documentation is available at https://borgitory.com

Prerequisites

Docker Installation (Recommended): Docker with Docker Compose for containerized deployment
PyPI Installation: Python 3.14+ for direct installation from PyPI

Installation

Option 1: Docker Installation (Recommended)

Pull and run the Docker image

# Using Docker directly
docker run -d \
  -p 8000:8000 \
  -v ./data:/app/data \
  -v /path/to/backup/sources:/backup/sources:ro \
  -v /path/to/borg/repos:/repos \
  --cap-add SYS_ADMIN \
  --device /dev/fuse \
  --name borgitory \
  mlapaglia/borgitory:latest

Or using Docker Compose (create a docker-compose.yml):

version: '3.8'
services:
  borgitory:
    image: mlapaglia/borgitory:latest
    ports:
      - "8000:8000"
    volumes:
      - ./data:/app/data # database and encryption key location
      - /path/to/backup/sources:/sources:ro
      - /path/to/any/backup/repos:/repos:ro
    cap_add:
      - SYS_ADMIN # optional, needed to mount borg archives and browse them
    devices:
      - /dev/fuse # borg uses FUSE to mount archives
    restart: unless-stopped

docker-compose up -d

Access the web interface
- Open http://localhost:8000 in your browser
- Create your first admin account on initial setup

Option 2: PyPI Installation

Install Borgitory directly from PyPI:

# Install stable release from PyPI
pip install borgitory

# Start the server
borgitory serve

# Or run with custom settings
borgitory serve --host 0.0.0.0 --port 8000

PyPI Installation Requirements:

Python 3.14 or higher
BorgBackup installed and available in PATH
Rclone (optional, for cloud sync features)
FUSE (optional, for browsing archives)

Windows Requirements:

WSL2 (Windows Subsystem for Linux) must be installed and configured
Inside WSL2, you need:
- BorgBackup installed (sudo apt install borgbackup or similar)
- Python 3.14+ installed
- Rclone installed (optional, for cloud sync features)
BorgBackup does not have a native Windows executable, so WSL2 is required for all backup operations

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

borgitory-2.8.0.tar.gz (995.0 kB view details)

Uploaded Aug 6, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

borgitory-2.8.0-py3-none-any.whl (926.2 kB view details)

Uploaded Aug 6, 2026 Python 3

File details

Details for the file borgitory-2.8.0.tar.gz.

File metadata

Download URL: borgitory-2.8.0.tar.gz
Upload date: Aug 6, 2026
Size: 995.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for borgitory-2.8.0.tar.gz
Algorithm	Hash digest
SHA256	`ccfc22fa32af4c9e49e556f578932de92d720fa362fb2cc21368a35ac1ceb72b`
MD5	`309affec3f06744c679d9e67436db90c`
BLAKE2b-256	`ec7d43531e335393abc2cc3ad365225b7f2d607762139cb6b8c615c98552d37b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for borgitory-2.8.0.tar.gz:

Publisher: release.yml on mlapaglia/Borgitory

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: borgitory-2.8.0.tar.gz
- Subject digest: ccfc22fa32af4c9e49e556f578932de92d720fa362fb2cc21368a35ac1ceb72b
- Sigstore transparency entry: 2359744286
- Sigstore integration time: Aug 6, 2026
Source repository:
- Permalink: mlapaglia/Borgitory@15a5ed4de30f8f065625ccc7216ce39a06245521
- Branch / Tag: refs/tags/v2.8.0
- Owner: https://github.com/mlapaglia
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@15a5ed4de30f8f065625ccc7216ce39a06245521
- Trigger Event: release