<div align="center"> <img src="https://github.com/user-attachments/assets/2132a842-4233-4d37-8fde-b2d23353ed76" width="100"/> <h1 <strong>Warracker</strong></h1> <p align="center"> <b>Open-source warranty tracker for individuals and teams.</b> <br/> The easiest way to organize product warranties, monitor expiration dates, and store receipts or related documents. </b> </p> </div> <div align="center">

GitHub issues GitHub license GitHub last commit GitHub release GitHub contributors

</div> ⭐ If you find Warracker helpful, we’d truly appreciate a star on GitHub! Your support motivates us to keep improving and building great new features.

🌟Overview

Warracker is a web-based application that simplifies the management of product warranties. It allows users to organize warranty information, monitor expiration dates, and securely store related documents.

🔑 Key Features

| Feature | -------------------------------- | 🗃️ Centralized Management | 🧾 Detailed Records | 📄 Document Storage | 📝 Warranty Claims | 🔔 Proactive Alerts | 🔍 Quick Search and Filter | #️⃣ Multiple Serial Numbers | 🌍 Global Warranty View | 👥 Multi-User Support | 📤 Data Export/Import | ⚙️ Customizable Settings | 🌐 Internationalization | 🏷️ Tagging | 📦 Archiving | 🔐 Password Reset | 🔑 OIDC SSO | 📊 Status Dashboard | 📱 Responsive UI | 📦 Paperless-ngx Integration | 📖 Localization Support | Description | | -------------------------------------------------------------------------------------------------------- | | Track all your product warranties in one place | | Store purchase dates, durations, notes, and product photos with thumbnail previews | | Upload receipts, invoices, and manuals securely | | Manage warranty claims end-to-end with statuses, dates, resolutions, and full lifecycle visibility | | Get alerts for upcoming expirations via email or 100+ push services (Discord, Slack, etc.) using Apprise | | Search by product name, serial number, vendor, tags, and more with real-time filtering | | Add and manage multiple serial numbers per product | | Authenticated users can view global warranty data with role-based permissions | | Manage multiple accounts with admin controls and global access toggles | | Import/export warranty data via CSV | | Configure currency, date formats, notification timing, and branding | Support | Support for multiple currencies and date formats tailored to regional preferences, enabling a seamless global user experience | | Organize warranties using custom tags | | Archive expired or unused warranties for better organization, while keeping records accessible when needed | | Token-based, secure account recovery system | | Single sign-on with providers like Google, GitHub, and Keycloak | | Visual analytics and stats with charts, tables, and global/user views | | Mobile-friendly interface with admin tools and improved UX | | Store/manage documents directly in Paperless-ngx with file-level control | | Full multilingual UI with 20 languages, RTL support, instant language switching, and native name display |

Project Status

Warracker is in active development. The essential features are reliable and ready for everyday use. Development is ongoing, with regular updates and improvements.

✅ Stable core for tracking, notification , and managing warranty documents, files
✅ Full support for self-hosted deployments
⚒️ Advanced enhancements are still being worked on
✍️ Your feedback and bug reports help shape the future of the app

📸Screenshots

Home Page

Status Dashboard

🛠️Technology Stack

Frontend: HTML, CSS, JavaScript
Backend: Python with Flask
Database: PostgreSQL
Containerization: Docker and Docker Compose
Web Server: Nginx

🗺️Roadmap

✅ User Authentication
✅ Settings Page
✅ Status Page
✅ Customizable Reminders
✅ Email Notifications
✅ Warranty Categories via Tags
✅ CSV Import/Export
✅ OIDC SSO Functionality
✅ Advanced User/Admin Controls
✅ Paperless-ngx integration
✅ Localization Support
✅ Warranty Claim Tracking
✅ Audit trail
[ ] Calendar Integration

🚀Setup

Prerequisites

Docker and Docker Compose installed on your system.

🐋Pull Docker

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
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER -d $$POSTGRES_DB"]
      interval: 5s
      timeout: 5s
      retries: 5

volumes:
  postgres_data:
  warracker_uploads:

To get the docker compose file with environemts and .env example for warracker and the warrackerdb please go here

📝 Usage

Accounts & Roles

The first account created in the system will automatically become the Admin account.
The Admin can manage other users, assign roles, and has full system permissions.
Regular users can only manage their own warranties unless granted additional privileges by the Admin.

Adding a Warranty

Fill in the product details by clicking on Add Warranty.
Enter the purchase date and warranty duration.
Optionally upload receipt/documentation.
Click the Add Warranty button.

Managing Warranties

Use the search box to filter warranties.
Click the edit icon to modify warranty details.
Click the delete icon to remove a warranty.

<details> <summary><strong>Product Information Entry Requirements for CSV import</strong></summary>

Click on Data > Import

| Field Name | Format / Example | Required? | Notes | |----------------|-------------------------------------------|--------------------------------------------------------|-----------------------------------------------------------------------| | ProductName | Text | ✅ Yes | Provide the name of the product. | | PurchaseDate | Date (YYYY-MM-DD, e.g., 2024-05-21) | ✅ Yes | Use ISO format only. | | WarrantyDurationYears | Whole Number (0, 1, 5) | ✅ Yes, if IsLifetime is FALSE and Months/Days are 0/blank. At least one duration field (Years, Months, Days) must be non-zero if not lifetime. | Represents the years part of the warranty. Can be combined with Months and Days. | | WarrantyDurationMonths | Whole Number (0, 6, 18) | ✅ Yes, if IsLifetime is FALSE and Years/Days are 0/blank. At least one duration field (Years, Months, Days) must be non-zero if not lifetime. | Represents the months part of the warranty. Can be combined with Years and Days. Max 11 if Years also provided. | | WarrantyDurationDays | Whole Number (0, 15, 90) | ✅ Yes, if IsLifetime is FALSE and Years/Months are 0/blank. At least one duration field (Years, Months, Days) must be non-zero if not lifetime. | Represents the days part of the warranty. Can be combined with Years and Months. Max 29/30 if Months also provided. | | ExpirationDate | Date (YYYY-MM-DD, e.g., 2031-10-08) | ❌ No (Optional) | Use this if duration fields are 0 and IsLifetime is FALSE. | | IsLifetime | TRUE or FALSE (case-insensitive) | ❌ No (Optional)

Warracker

Install / Use

README