VolumeVault

VolumeVault is a self-hosted Laravel application for managing Docker volume backups and safe restores through offen/docker-volume-backup.

It provides a clear web UI for scheduled backups, restore runs, encrypted destinations, notifications, run history, onboarding, and API-driven automation.

Get Started

Generate an application key first:

docker run --rm ghcr.io/darkdragon14/volumevault:latest php artisan key:generate --show

Create a docker-compose.yml file and paste the generated key in APP_KEY:

services:
  volumevault:
    image: ghcr.io/darkdragon14/volumevault:latest
    ports:
      - "8080:8080"
    volumes:
      - volumevault_data:/app/storage
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      APP_KEY: base64:paste-generated-key-here
    restart: unless-stopped

volumes:
  volumevault_data:

Start VolumeVault:

docker compose up -d

Open http://localhost:8080 and create the first administrator account from the onboarding screen.

The container listens on port 8080; change the host side of the mapping, for example 9090:8080, if you want to expose VolumeVault on another port.

The single container runs nginx, PHP-FPM, database migrations, queue worker, and scheduler.

Defaults are built into the application for a production SQLite setup. Add environment variables only when you need to override them, for example APP_URL, APP_TIMEZONE, or SMTP settings.

You can also use env_file: .env for overrides, but do not reuse a development .env in production without review. Values such as APP_ENV=local or APP_DEBUG=true override the safe production defaults.

Keep your APP_KEY safe: it is required to decrypt destinations, notifications, and installation saves.

Documentation

The full documentation is published with GitHub Pages and built from the docs directory.

• Documentation URL: https://darkdragon14.github.io/VolumeVault/
• Documentation source: docs/index.md

Credits

VolumeVault relies on offen/docker-volume-backup for the actual Docker volume backup engine and destination support.

Huge thanks to Offen and the maintainers of offen/docker-volume-backup for their work.

Contributing

All contributions are welcome.