l4rm4nd/VoucherVault

What is it?

Key features

• 01Stores vouchers, coupons, gift cards and loyalty cards with redeem codes.
• 02Displays codes as QR codes or barcodes, with client-side scanning on creation.
• 03Sends expiry notifications through Apprise.
• 04Supports multiple users, item sharing and OIDC single sign-on.
• 05Offers a mobile-friendly PWA with 48-hour offline caching.
• 06Provides a REST API with stats for Home Assistant and other dashboards.

Use cases

• Keeping loyalty and gift cards from several stores in one digital wallet.
• Getting reminders before vouchers or coupons expire.
• Sharing gift cards with family members on a home server.
• Showing voucher stats on a Home Assistant dashboard.

Quick start

1. 1

   Create the persistence volume directory

   mkdir -p ./volume-data/database
2. 2

   Adjust volume ownership to www-data (UID/GID 33)

   sudo chown -R 33:33 volume-data/*
3. 3

   Start the container stack with Docker Compose

   docker compose -f docker/docker-compose-sqlite.yml up -d
4. 4

   Open http://127.0.0.1:8000 and get the auto-generated admin password from the container logs

   docker compose -f docker/docker-compose-sqlite.yml logs -f

Things to know

• !Requires Docker and a reverse proxy with TLS for secure production use.
• !Self-hosting setup involves manual volume permission changes and environment configuration.
• !Licensed under GPL-3.0, a copyleft license requiring derivative works to be open source.

In collections

Topics

FAQ

What is VoucherVault?

Self-hosted Django web app for storing and managing vouchers, coupons, loyalty cards and gift cards, with expiry notifications. VoucherVault is a self-hosted Django web application for keeping track of vouchers, coupons, loyalty cards and gift cards in one place. Each item can store its redeem code, which is displayed as a QR code or barcode, and can carry uploaded images or PDFs. Gift cards also keep a transaction history.

Is VoucherVault free to use? What license does it have?

VoucherVault is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.

Is VoucherVault still maintained?

Actively maintained. The last commit to VoucherVault was on Nov 3, 2026.

What can I use VoucherVault for?

Keeping loyalty and gift cards from several stores in one digital wallet. Getting reminders before vouchers or coupons expire. Sharing gift cards with family members on a home server. Showing voucher stats on a Home Assistant dashboard.

How do I install VoucherVault?

Create the persistence volume directory: mkdir -p ./volume-data/database Adjust volume ownership to www-data (UID/GID 33): sudo chown -R 33:33 volume-data/* Start the container stack with Docker Compose: docker compose -f docker/docker-compose-sqlite.yml up -d Open http://127.0.0.1:8000 and get the auto-generated admin password from the container logs: docker compose -f docker/docker-compose-sqlite.yml logs -f

Where can I get VoucherVault?

The source code and installation instructions are on GitHub: https://github.com/l4rm4nd/VoucherVault