A self-hosted solution to track warranties, manage receipts, and get expiration alerts — perfect for tech-savvy teams, organized minds, and forgetful users alike.
When your washing machine breaks down and no one knows if it’s still under warranty, the panic usually leads to endless searches through emails and folders. We’ve all been there. So was Sassanix. That experience sparked the creation of Warracker, a simple yet powerful open-source web app that tracks warranties, stores documents, and reminds you before it’s too late.
📌 What Is Warracker?
Warracker is a self-hosted warranty tracker for individuals and teams. It lets you organize product warranties, track expiration dates, and securely upload invoices, receipts, manuals or product photos — all from a clean, browser-based interface.
Designed for both everyday consumers and professionals managing fleets of devices, Warracker blends flexibility, transparency and control over your purchase records.
🔑 Key Features at a Glance
| Feature | Description |
|---|---|
| 🗃️ Centralized Management | Keep all warranty records in one searchable location |
| 📄 Document Storage | Upload receipts, manuals, photos — all securely stored |
| 🔔 Smart Alerts | Get expiration reminders via email or over 100 push channels (Discord, Slack, etc.) using Apprise |
| 📤 CSV Import/Export | Easily back up or bulk upload warranty data |
| 🧾 Tagging System | Categorize products with custom tags |
| 🔐 OIDC SSO + Multi-User | Secure role-based access with Google, GitHub, Keycloak, etc. |
| 📊 Status Dashboard | See global or user-level stats and charts for your warranties |
| 🌍 Global View (Role-Based) | Authenticated users can view or manage data depending on permissions |
| 📱 Mobile-Responsive UI | Works seamlessly on phones, tablets and desktops |
| 🧾 Paperless-ngx Integration | Native support to manage documents using Paperless-ngx |
| #️⃣ Multiple Serial Numbers | Assign multiple serials to one product |
📷 Screenshots
⚙️ Tech Stack
| Component | Technology |
|---|---|
| Frontend | HTML, CSS, JavaScript |
| Backend | Python (Flask) |
| Database | PostgreSQL |
| Container | Docker + Compose |
| Web Server | Nginx |
🐳 Quick Deployment via Docker Compose
services:
warracker:
image: ghcr.io/sassanix/warracker/main:latest
ports:
- "8005:80"
volumes:
- warracker_uploads:/data/uploads
env_file:
- .env
depends_on:
warrackerdb:
condition: service_healthy
restart: unless-stopped
warrackerdb:
image: postgres:15-alpine
volumes:
- postgres_data:/var/lib/postgresql/data
env_file:
- .env
restart: unless-stopped
volumes:
postgres_data:
warracker_uploads:
Code language: JavaScript (javascript)📋 CSV Import Format
| Field | Format / Example | Required? | Notes |
|---|---|---|---|
ProductName | Text | ✅ Yes | Name of the item |
PurchaseDate | YYYY-MM-DD (e.g. 2025-07-08) | ✅ Yes | ISO format only |
WarrantyDurationYears | Integer (e.g. 2) | ✅ If IsLifetime is FALSE | Can be combined with months/days |
IsLifetime | TRUE / FALSE | ❌ Optional | Ignores duration fields if TRUE |
SerialNumber | Text (“SN001,SN002”) | ❌ Optional | Multiple serials supported |
Vendor | Text | ❌ Optional | Seller or brand |
Tags | Text (“home,tech”) | ❌ Optional | Tag products for grouping |
PurchasePrice | Decimal (e.g. 199.99) | ❌ Optional | Price of the product |
💡 Why Warracker?
“I built Warracker after a frustrating personal moment — my dad’s dishwasher broke, we had the invoice, but discovered the warranty had expired by just a few weeks. That incident made me realize: we all need a better way to track these things.”
— Sassanix, creator of Warracker
That moment sparked a project that has already saved users money by helping them claim repairs before warranties expire. It gives you peace of mind and saves time when it matters most.
🗺️ Roadmap Highlights
| Upcoming Feature | Status |
|---|---|
| Warranty claim tracking | 🟡 In progress |
| Calendar integration | 🔜 Planned |
| Full localization | 🔜 Planned |
| Audit logs | 🔜 Planned |
🙌 How to Contribute
Warracker is licensed under AGPLv3 and welcomes contributions from the community.
Ways to help:
- Submit bug reports or feature requests via GitHub Issues
- Fork and improve: PRs are welcome
🧠 Final Thoughts for Curious Minds
We live in a world full of warranties, receipts and return policies — yet most people have no system to manage them. Warracker offers a digital memory for your purchases, blending privacy, control and open-source ethics.
Whether you’re a minimalist, a digital archivist, a parent managing a household, or an IT admin tracking devices, this app gives you clarity in a space too often left to chance.
In a time where ownership is blurry and planned obsolescence is common, knowing your rights and coverage might save you hundreds of euros — and a lot of frustration.
