Mounting Borg Archives

Borg Web UI exposes Borg’s borg mount and borg umount so you can mount a repository or a specific archive as a read-only filesystem inside the container. This lets you browse backup contents as normal directories and copy files out without using the in-app archive browser.

What You Get

Borg mount in the UI: Choose an archive and mount it; the filesystem appears under /data/mounts/ inside the container.
Read-only: Mounted archives are always read-only; you cannot modify backup contents.
Manage mounts: List active mounts and unmount from Settings → Management → Mounts. Mounts are cleared when the container restarts.

How to Use

Mounting an Archive

Go to Archives and select the repository.
Click Mount on the archive you want.
Optionally enter a Mount Name (e.g. my-backup). If omitted, the archive name is used.
Click Mount. When it succeeds, the UI shows the path and a docker exec command you can use to access it.

The archive is mounted at a path like /data/mounts/my-backup inside the container.

Managing Mounts

Settings → Management → Mounts shows all active Borg archive mounts.
Use Unmount to unmount when done. Force unmount is available if the mount is busy.

Mounts do not survive container restarts. Unmount before restarting if you need a clean shutdown, or they will be cleared on next start.

Docker Requirements (FUSE)

Borg mount uses FUSE (Filesystem in Userspace). The container must have:

Access to the FUSE device: devices: /dev/fuse
Capability to mount: cap_add: SYS_ADMIN

Accessing Mounted Files

Option 1: Inside the Container (`docker exec`)

After mounting, use the path shown in the UI:

docker exec -it borg-ui ls /data/mounts/my-backup

Replace borg-ui with your container name and my-backup with your mount name.

Option 2: On the Host (Without `docker exec`)

You can make FUSE mounts created inside the container visible on the host by bind-mounting a host directory to /data/mounts with shared propagation. Then any archive you mount in the UI appears under that host path.

Minimal Docker Compose example:

services:
  borg-ui:
    image: ainullcode/borg-ui:latest
    container_name: borg-ui
    cap_add:
      - SYS_ADMIN   # Needed to mount borg archives and browse them
    devices:
      - /dev/fuse   # Needed to mount borg archives and browse them
    volumes:
      # FUSE mounts inside the container appear on the host here
      - type: bind
        source: /path/to/host/mountpoint
        target: /data/mounts
        bind:
          propagation: shared
    ports:
      - 8081:8081

Replace /path/to/host/mountpoint with a directory on your host (e.g. /mnt/borg-mounts). After you mount an archive in the UI, it will appear under that path on the host.

Timeouts for Large Repositories

Large repositories can take a long time to mount. The default Mount Timeout is 2 minutes. If mounts fail with timeout errors or you see “Process still running” / “Mount timeout” in the logs, increase the timeout.

Settings → System → System → Operation Timeouts: set Mount Timeout (e.g. 600 seconds for 10 minutes).

See the Configuration Guide for all timeout options and recommended values for very large repos.

Security

Mounted archives are read-only; backup data cannot be modified via the mount.
Using cap_add: SYS_ADMIN and devices: /dev/fuse increases container privileges. Prefer the minimal FUSE setup (as in the Installation Guide) over privileged mode. See the Security Guide for best practices.