Warranty Watcher

A warranty information management system that bridges the gap between IT management platforms and manufacturer warranty databases. This system democratizes warranty lookups, making it accessible and transparent for IT professionals and managed service providers (MSPs).

Demo: https://demo.warrantywatcher.com/ (DO NOT ENTER YOUR DATA)

View Example Report: Example Report

Don't want to self-host? Try it on cloud here: https://warrantywatcher.com

Features

• Multi-Platform Integration: Connect to various IT management platforms to retrieve device information
• Manufacturer API Integration: Query multiple manufacturer warranty APIs to determine warranty status
• Local Database: Device information is stored in a local SQLite database for persistence and performance
• Local API Credential Storage: Configuration is stored in each user's browser local storage for privacy.
• CSV Import: Import device information via CSV file
• Reporting: Generate and export warranty status reports

Supported Platforms

• PSA Tools

  • ✅ HaloPSA

• RMM Platforms

  • ✅ Datto RMM
  • ✅ N-able N-central

• Other

  • ✅ CSV Files (for standalone reporting)

Supported Manufacturers

• ✅ Dell
• ✅ HP
• ✅ Lenovo
• ⏳ Microsoft (planned)
• ⏳ Apple (planned)

Getting Started (Self-Hosting)

Prerequisites

• For Production: Docker
• For Development: Node.js 18.0.0 or later

Production Deployment

Option 1: Docker Hub Image (Recommended)

docker run -p 3000:3000 -v ./data:/app/data -e DB_PATH=/app/data/warranty.db mhaowork/warrantywatcher:latest

Note: your device database will be saved in the data folder under your current directory

Access the application at http://localhost:3000

Tip: How to upgrade to the latest version

Find your container ID

docker ps

Stop and remove the container

docker stop CONTAINER_ID && docker rm CONTAINER_ID

Pull the latest image

docker pull mhaowork/warrantywatcher:latest

Then you can execute the docker run command again.

Option 2: Build from Source

git clone https://github.com/mhaowork/warranty-watcher.git
cd warranty-watcher
docker-compose up -d

Then you can run the latest image.

Development Setup (Ignore this unless you want to change the code Or don't want to use Docker)

1. Clone the repository

   git clone https://github.com/mhaowork/warranty-watcher.git
   cd warranty-watcher

2. Install dependencies

   npm install

3. Run the development server

   npm run dev

4. Open http://localhost:3000 in your browser

Usage

1. Configure manufacturer API credentials (Dell, HP, etc.)

   • For Dell API setup, see Dell Warranty API Guide to get your API key
   • For HP & Lenovo API setup, see this API Guide to get an API key

2. Configure platform credentials (Datto RMM, N-Central etc)

   • Datto RMM: See the official guide to activate the API and get your key
   • N-central RMM: Follow this doc to create an API-only user and get your JSON Web Token aka API key.
   • HaloPSA: See this guide for how to set up the connection for importing devices.

3. Sync devices from your platform or upload a CSV file.

4. View and export warranty information. You can choose to write the warranty info back to the source platform (RMM / PSA)

Detailed Documentation

https://deepwiki.com/mhaowork/warranty-watcher