Skip to content
Klutch.sh Docs

Deploying Warracker

Introduction

Warracker is a self-hosted warranty tracking application that helps you manage and monitor warranties for all your products. Stop losing track of warranty expirations or scrambling to find purchase receipts when something breaks. Warracker centralizes all warranty information in one accessible location.

Built as a lightweight web application, Warracker provides an intuitive interface for adding products, tracking warranty periods, uploading receipts and documentation, and receiving notifications before warranties expire.

Key features of Warracker include:

  • Product Management: Add products with warranty start and end dates
  • Document Storage: Upload and store receipts, invoices, and warranty cards
  • Expiration Tracking: Visual indicators for active, expiring soon, and expired warranties
  • Category Organization: Group products by category for easy browsing
  • Search and Filter: Quickly find products and warranties
  • Expiration Alerts: Get notified before warranties expire
  • Data Export: Export warranty data for backup purposes
  • Mobile-Responsive: Access your warranty information from any device

This guide walks you through deploying Warracker on Klutch.sh using Docker with persistent storage for your warranty data and documents.

Prerequisites

Before deploying Warracker on Klutch.sh, ensure you have:

Repository Structure

Create a GitHub repository with the following structure:

warracker-deploy/
├── Dockerfile
└── .dockerignore

Dockerfile

Create a Dockerfile in your repository:

FROM cassidyrose/warracker:latest


# Warracker web interface port
EXPOSE 8000


# The base image handles the entrypoint

Environment Variables

VariableRequiredDefaultDescription
TZNoUTCTimezone for date calculations

Deployment on Klutch.sh

  1. Push your Dockerfile to your GitHub repository.
  2. Log in to Klutch.sh and create a new project.
  3. Create a new app within your project and connect your GitHub repository containing the Dockerfile.
  4. Configure the deployment settings: - Select **HTTP** as the traffic type - Set the internal port to **8000**
  5. Add environment variables: - `TZ`: Your timezone (e.g., `America/New_York`)
  6. Attach persistent volumes: - Mount path: `/app/data` - Recommended size: 5 GB - Purpose: Database, uploaded documents, and receipts
  7. Click **Deploy** and wait for the build to complete.
  8. Access your Warracker instance at the provided URL and start adding your warranties.

Post-Deployment Configuration

After deployment:

  1. Access the web interface
  2. Create product categories (Electronics, Appliances, Tools, etc.)
  3. Add your first product with warranty information
  4. Upload receipts and warranty documentation

Troubleshooting

Uploaded Files Not Saved

Ensure the persistent volume is correctly mounted at /app/data. This stores both the database and uploaded files.

Timezone Issues

Set the TZ environment variable to ensure warranty dates display correctly in your local timezone.

Additional Resources