Skip to content

💾 Velld — Database Backup Manager

Host: Homelab · Compose: Homelab/Docker/velld/compose.yaml
Stack name: velld

1. Overview

Velld is a self-hosted database backup management tool with a web UI. It provides scheduled backups, backup history, and restore capabilities for PostgreSQL and other databases across the homelab.

2. Architecture & Services

Service Image Port Role
api ghcr.io/dendianugerah/velld/api:latest@sha256:c447f3f18f3976267b1bb68157b491a0021e14d5f64c11efebc8d87d2b493a89 48080 Backup scheduler and executor API
web ghcr.io/dendianugerah/velld/web:latest@sha256:9f071d2a23fe35ef40f420d47580b74e32056c18b37e60175f8c91f4242aaa2c 43000 Next.js web frontend

3. Networking

  • cloudflare-net — —
  • database — —
  • internal — —
  • traefik — —

4. Persistent Storage

| Container | Host Path / Volume | Description | |---|---|---|| | api | /docker/services/velld/api_data | Job configs and state | | api | /docker/services/velld/backup_data | Generated backup files |

5. Environment Variables

Variable Service Description
ALLOW_REGISTER web Enable user registration
NEXT_PUBLIC_API_URL web URL of the Velld API

6. Access & Usage

URL Description
http://localhost:43000 Velld web UI
http://localhost:48080 Velld API 
docker compose -f Homelab/Docker/velld/compose.yaml up -d

7. Maintenance & Backup

# Update
docker compose -f Homelab/Docker/velld/compose.yaml pull
docker compose -f Homelab/Docker/velld/compose.yaml up -d

# Backup Velld's own data
rsync -av /docker/services/velld/ /backup/velld/