💾 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	dendianugerah/velld/api	48080	Backup scheduler and executor API
web	dendianugerah/velld/web	43000	Next.js web frontend

---

3. Networking

Both services share database (external) and internal (external) networks. The web UI also connects to cloudflare-net and traefik for external access.

---

4. Persistent Storage

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

---

5. Environment Variables

Loaded from .env:

Variable	Service	Description
NEXT_PUBLIC_API_URL	web	URL of the Velld API
ALLOW_REGISTER	web	Enable user registration
Database credentials	api	Connection strings for managed databases

---

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/