Instalar Warracker con Docker: gestiona tus garantías sin perder la cabeza

Cuando compramos un electrodoméstico, un móvil o cualquier gadget caro, casi todos hacemos lo mismo: guardamos la factura “en algún sitio seguro”… y luego nunca volvemos a verla. Años después, el producto falla y llega la gran pregunta: ¿seguía en garantía o no?

Para evitar ese drama existe Warracker, una aplicación web open source pensada para registrar garantías, controlar fechas de expiración y almacenar documentos asociados, como facturas o manuales. Todo en un solo lugar, accesible desde tu navegador.

En este artículo vas a ver qué ofrece Warracker y cómo desplegarlo fácilmente con Docker.

¿Qué es Warracker y para qué sirve?

Warracker es una app web autoalojable (self-hosted) que funciona como tu archivo digital de garantías. La idea es simple: introducís la información de un producto, subís la factura, y el sistema te avisa cuando se acerca la fecha de vencimiento.

Además, al ser open source, puedes instalarlo en tu propio servidor doméstico o VPS, sin depender de servicios externos.

Nota: el proyecto será multilingüe próximamente, así que su interfaz irá ampliando idiomas.

Características principales

Warracker destaca por ser minimalista, útil y muy orientado al día a día. Entre sus funciones clave están:

Gestión centralizada de todas tus garantías.
Registro completo: producto, fecha de compra, duración, vendedor, serie, precio y notas.
Almacenamiento de documentos: facturas, recibos, manuales, etc.
Alertas proactivas: notificaciones antes de que caduque una garantía.
Búsqueda y filtros rápidos por nombre, proveedor, número de serie, tags o notas.
Multiusuario con control administrativo.
Importación y exportación CSV para respaldos o migraciones.
Notificaciones por correo configurables.
Personalización de moneda, formato de fecha y tamaño máximo de subida.
Sistema de etiquetas (tags) para organizar por categorías.
Recuperación de contraseña mediante token seguro.

Instalación con Docker

La instalación es directa: un contenedor para la app y otro para PostgreSQL.

Prerrequisitos

Antes de empezar asegúrate de tener:

Una distro Linux (Ubuntu, Debian, etc.).
Docker y Docker Compose instalados.
Acceso a terminal.
Conexión a internet.

Paso 1: crear el `compose.yml`

En la carpeta donde quieras desplegar Warracker:


nano compose.yml

Pega lo siguiente:


services:
  warracker:
    image: ghcr.io/sassanix/warracker/main:latest
    ports:
      - "8005:80"
    volumes:
      - warracker_uploads:/data/uploads
    environment:
      - DB_HOST=warrackerdb
      - DB_NAME=warranty_db
      - DB_USER=warranty_user
      - DB_PASSWORD=Mot_de_Passe
      - SMTP_HOST=smtp.email.com
      - SMTP_PORT=465
      - SMTP_USERNAME=youremail@email.com
      - SMTP_PASSWORD=password
      - SECRET_KEY=JNkjGhGHG5745sdfsdf 
      - MAX_UPLOAD_MB=32
      - NGINX_MAX_BODY_SIZE_VALUE=32M
    depends_on:
      warrackerdb:
        condition: service_healthy
    restart: unless-stopped
  
  warrackerdb:
    image: postgres:15-alpine
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=warranty_db
      - POSTGRES_USER=warranty_user
      - POSTGRES_PASSWORD=Mot_de_passe
    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:

Paso 2: personalizar variables importantes

En el servicio warracker:

DB_USER → usuario de la base de datos (puedes cambiarlo).
DB_PASSWORD → contraseña fuerte para la BD.
SMTP_* → datos de tu servidor de correo para notificaciones.
SECRET_KEY → cámbiala sí o sí por una clave larga y aleatoria.
MAX_UPLOAD_MB → límite de tamaño al subir facturas.
NGINX_MAX_BODY_SIZE_VALUE → debe tener coherencia con el valor anterior.

En warrackerdb:

POSTGRES_USER y POSTGRES_PASSWORD deben coincidir con DB_USER y DB_PASSWORD.

Paso 3: levantar los contenedores


docker compose up -d

Paso 4: acceder a la aplicación

Ve a tu navegador:

En local: http://IP_DEL_SERVIDOR:8005/
Con dominio: https://warracker.tudominio.com

Primer inicio: crear el administrador

Al entrar por primera vez:

Pulsa Create Account.
Completa:
- First Name / Last Name (opcionales)
- Username
- Email Address
- Password y Confirm Password
Confirma con Create Account.

Listo: te enviará al panel principal.

Cómo añadir una garantía

En el dashboard:

Click en + Add New Warranty.
Rellena por pasos:
- Nombre del producto
- URL (opcional)
- Número de serie
- Vendedor (opcional)
Añade:
- Fecha de compra
- Duración de garantía
- Precio
- Nota (si quieres)
Sube documentos:
- Factura (clave)
- Manual (opcional)
Añade tags si te interesa.
Revisa el resumen final y pulsa Add Warranty.

Y ya tienes esa garantía controlada.

Crear tags para organizarte

En Manage Tags:

Escribe el nombre del tag.
Elige color.
Pulsa Add Tag.
Cierra con Close.

Ejemplos útiles: Electrodomésticos, PC, Cocina, Trabajo, 2025, etc.

Ajustes y opciones

En tu usuario (arriba a la derecha) → Settings.

Preferencias

Tema claro u oscuro.
Vista en grid o lista.
Moneda.
Días antes para marcar “Expira pronto”.
Formato de fecha.
Guardar con Save Preferences.

Ajustes del sitio

Permitir o no el registro de nuevos usuarios.
URL oficial de tu instancia.
Guardar con Save Site Settings.

Ajustes de correo

Activar/desactivar notificaciones.
Frecuencia de envío.
Hora de recepción.
Zona horaria.
Guardar con Save Email Settings.

Panel de estado

En Status tendrás un tablero visual con:

Garantías activas
Próximas a expirar
Caducadas

Ideal para revisar de un vistazo sin entrar una por una.

Importar o exportar backups

En dos clics:

Export CSV → respaldo de todas las garantías.
Import CSV → restaurar o migrar datos.

Esto te permite:

guardar copia periódica,
migrar de servidor,
o editar masivamente datos en una hoja de cálculo.

Consejos rápidos para un despliegue sólido

Usa una SECRET_KEY fuerte (tipo contraseña de 32+ caracteres aleatorios).
Si publicas la app en internet, ponla detrás de un proxy con HTTPS (Caddy, Nginx Proxy Manager, Traefik).
Haz backups regulares del volumen postgres_data.
Ajusta bien MAX_UPLOAD_MB si guardas PDFs pesados.

Cierre

Warracker es una solución sencilla pero muy práctica: un “archivo de garantías inteligente” que evita pérdidas de tiempo y dinero. En 10 minutos lo tienes corriendo con Docker y desde entonces ya no dependes de carpetas físicas, correos perdidos o fotos sueltas de tickets.

En resumen: menos caos, más control.

🔗 Enlaces de Interés y Apoyo al Canal 🔗

Si te ha servido este contenido, apoya mi canal YouTube suscribiéndote: https://bit.ly/3NKeL8K
Puedes invitarme a un Ko-fi: https://ko-fi.com/genbyte
Mail de contacto: genbyte@proton.me

Comunidad GENBYTE

✉️ Canal Telegram: https://t.me/genbyte404
💬 Discord: https://discord.gg/fnggVjy6

Redes

📼 Youtube: https://www.youtube.com/@genbyte
⛓ Github: https://github.com/JLalib
💻 Blog: https://genbyte.blogspot.com/
🐦 Twitter: https://twitter.com/gen_byte

Buscar este blog

Bilal Jebari