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

el

 

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:

  1. Pulsa Create Account.

  2. Completa:

    • First Name / Last Name (opcionales)

    • Username

    • Email Address

    • Password y Confirm Password

  3. Confirma con Create Account.

Listo: te enviará al panel principal.

Cómo añadir una garantía

En el dashboard:

  1. Click en + Add New Warranty.

  2. Rellena por pasos:

    • Nombre del producto

    • URL (opcional)

    • Número de serie

    • Vendedor (opcional)

  3. Añade:

    • Fecha de compra

    • Duración de garantía

    • Precio

    • Nota (si quieres)

  4. Sube documentos:

    • Factura (clave)

    • Manual (opcional)

  5. Añade tags si te interesa.

  6. Revisa el resumen final y pulsa Add Warranty.

Y ya tienes esa garantía controlada.

Crear tags para organizarte

En Manage Tags:

  1. Escribe el nombre del tag.

  2. Elige color.

  3. Pulsa Add Tag.

  4. 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 🔗

Comunidad GENBYTE

Redes

Comentarios

Publicar un comentario