VoucherVault
A Django web application for digitally storing and managing vouchers, coupons, loyalty cards, and gift cards with PWA support.
What is VoucherVault?
VoucherVault is a Django-based web application that allows users to digitally store, organize, and manage vouchers, coupons, loyalty cards, and gift cards. It solves the problem of physical clutter and forgotten expirations by providing a centralized, searchable digital vault with features like expiry notifications and transaction tracking.
Individuals and families looking to organize their promotional cards and vouchers, as well as tech-savvy users who prefer self-hosted solutions over commercial cloud services.
Developers choose VoucherVault for its privacy-focused, self-hosted design, extensive feature set including PWA support and OIDC SSO, and seamless integration with home automation platforms like Home Assistant.
Overview
Django web application to store and manage vouchers, coupons, loyalty and gift cards digitally. Supports PWA, offline caching, expiry notifications, transaction histories, file uploads and OIDC SSO.
Use Cases
Best For
- Digitally organizing a large collection of gift cards and loyalty programs
- Self-hosting a private voucher manager with family or multi-user access
- Receiving automated expiry reminders for time-sensitive coupons
- Scanning and storing barcode/QR code vouchers directly from a phone camera
- Integrating voucher stats into a Home Assistant dashboard
- Managing vouchers offline or in areas with limited internet connectivity
Not Ideal For
- Users seeking a zero-configuration, cloud-based voucher manager with automatic syncing across devices
- Large teams requiring granular, enterprise-level access controls and audit logs beyond basic multi-user support
- Non-technical individuals uncomfortable with Docker containers, environment variables, and server administration
- Projects needing deep integration with commercial point-of-sale systems or retail APIs
Pros & Cons
Pros
The mobile-optimized progressive web app supports manual offline mode with 48-hour caching, allowing voucher access without an internet connection, as highlighted in the README's features.
Client-side scanning via camera or file upload automatically detects 1D and 2D barcode types, simplifying voucher entry without server-side processing.
Uses Apprise for notifications with customizable thresholds (via environment variables like EXPIRY_THRESHOLD_DAYS), reducing missed redemptions through scheduled daily checks.
Supports multiple user accounts with optional OpenID Connect single sign-on, enabling secure family or team access, as detailed in the authentication wiki.
Provides REST API endpoints for stats, allowing seamless dashboard integration with home automation platforms, a key feature for tech-savvy users.
Cons
Requires Docker knowledge, manual volume permission adjustments (e.g., chown to www-data), and extensive environment variable configuration, which can be a barrier for non-technical users.
Expiry notifications rely on external Apprise setup, adding an extra layer of configuration and a potential point of failure, as acknowledged in the notifications wiki.
Critical installation and configuration details are relegated to a separate wiki, making initial setup less straightforward from the main repository page, requiring additional navigation.
Only supports SQLite3 and PostgreSQL, lacking options for other popular databases like MySQL, which might restrict deployment flexibility for some environments.
Frequently Asked Questions
Related Projects
SureThe personal finance app for everyone (by everyone)
ExpenseOwlExtremely simple, self-hosted expense tracker with a beautiful UI.
OpenBudgeteerOpenBudgeteer is a budgeting app based on the Bucket Budgeting Principle
WYGIWYHA simple but powerful self-hosted finance tracker
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.