Skip to content

feat: add Kopia UI for VolSync backup repository browsing #1493

Description

@ixxeL2097

Overview

Deploy the Kopia web UI as a read-only browser for VolSync backup repositories, providing a visual way to inspect, verify, and restore from backups without CLI access.

Context

VolSync is already deployed on genmachine using the Restic/Kopia backend. Currently the only way to inspect backup content is via CLI (restic snapshots, kopia snapshot list). A web UI makes backup health verification straightforward.

What Kopia UI provides

  • Browse snapshots per application (by backup path)
  • View files within a snapshot
  • Verify snapshot integrity
  • Estimate restore size before executing
  • Simple web interface accessible via Ingress

Implementation

containers:
  - name: kopia
    image: kopia/kopia:latest
    args:
      - server
      - start
      - --insecure
      - --address=0.0.0.0:51515
      - --server-username=admin
      - --server-password=$(KOPIA_PASSWORD)
    volumeMounts:
      - name: backup-repository
        mountPath: /repository
        readOnly: true
volumes:
  - name: backup-repository
    # Mount the same NFS/S3/storage used by VolSync ReplicationSources
    nfs:
      server: nas.fredcorp.com
      path: /volsync

The Kopia pod mounts the same backup destination as the VolSync ReplicationSource (read-only) and exposes a web UI at kopia.fredcorp.com.

Reference

  • Inspired by szinn/k8s-homelab kopia deployment
  • Manifest location: gitops/manifests/kopia/

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions