Snipe-IT | Asset Management | Docker
Snipe-IT: Gestión de activos IT completa en Docker
Sistema open source para inventario y seguimiento de activos IT, licencias, consumibles y accesorios. Código QR, auditorías, depreci
ación y mucho más.
¿Qué es Snipe-IT?
Snipe-IT es un
sistema de gestión de activos IT de código abierto construido en Laravel. Está diseñado para que los departamentos de IT puedan rastrear quién tiene qué, cuándo fue comprado, cuándo caduca la garantía, y mucho más.
A diferencia de hojas de cálculo o soluciones propietarias costosas, Snipe-IT ofrece una interfaz web completa para gestionar hardware, software, licencias, consumibles, componentes y accesorios. Todo con seguimiento de ubicación, asignación de usuarios, generación de etiquetas QR, alertas de auditoría y reportes de depreciación.
Filosofía open source: Snipe-IT es completamente gratuito y de código abierto bajo licencia AGPL. Sin límites artificiales de usuarios, activos o funciones. También está disponible una versión cloud hospedada si prefieres no gestionar la infraestructura.
Características principales
Gestión de activos
Hardware, computadoras, monitores, teléfonos, tablets, servidores con asignación a usuarios/ubicaciones.
Licencias de software
Seguimiento de licencias con asignación, renovaciones, vencimientos y control de seats disponibles.
Consumibles
Tóners, cartuchos, cables, ratones, teclados con seguimiento de inventario mínimo y alertas.
Componentes
RAM, discos duros, tarjetas gráficas instalados dentro de activos con historial de cambios.
Accesorios
Artículos que se prestan a usuarios: ratones, teclados, monitores externos con check-in/check-out.
Códigos QR y de barras
Generación automática de etiquetas QR para check-in/out rápido via app móvil o escáner.
Auditorías programadas
Alertas de auditoría próxima, fechas de última auditoría y reportes de cumplimiento.
Depreciación
Múltiples métodos de depreciación (lineal, declive doble) con reportes de valor actual.
Campos personalizados
Añade campos adicionales específicos de tu organización con validación y encriptación opcional.
API REST completa
Automatización e integración con sistemas externos via API documentada.
LDAP/SAML
Integración con Active Directory, Azure AD, Google Workspace para SSO.
Reportes y exportación
Exporta a CSV, PDF con reportes personalizables de activos, licencias, auditorías.
Requisitos previos
- Docker y Docker Compose instalados
- Al menos 2 GB de RAM disponible
- Espacio en disco: 5-10 GB para aplicación y base de datos
- Puerto 8000 disponible (o el que configures)
Instalación con Docker Compose
Paso 1: Crear directorio del proyecto
mkdir ~/snipeit
cd ~/snipeit
Paso 2: Descargar archivos de configuración
curl https://raw.githubusercontent.com/snipe/snipe-it/master/docker-compose.yml \
-o docker-compose.yml
curl https://raw.githubusercontent.com/snipe/snipe-it/master/.env.docker \
-o .env
Paso 3: Configurar variables de entorno
Edita el archivo .env y ajusta los siguientes valores obligatorios:
nano .env
Variables obligatorias
DB_DATABASE=snipeit
DB_USERNAME=snipeit
DB_PASSWORD=contraseña-segura-aqui
MYSQL_ROOT_PASSWORD=root-password-segura
APP_URL=http://localhost:8000
APP_PORT=8000
Paso 4: Generar APP_KEY
Snipe-IT necesita una clave de aplicación única. Genera una ejecutando:
docker compose run --rm app php artisan key:generate --show
Copia el resultado (algo como base64:ABC123...) y añádelo al archivo .env:
APP_KEY=base64:ABC123456789...
Paso 5: Iniciar los contenedores
docker compose up -d
Paso 6: Acceder al instalador web
Abre tu navegador y ve a: http://localhost:8000
Sigue el asistente de configuración inicial:
- Pre-Flight Check (verificación de requisitos)
- Crear cuenta de administrador
- Configuración del sitio (nombre, email, zona horaria)
- Configuración de email (opcional por ahora)
Configurar correo saliente (SMTP)
Edita el archivo .env con tu configuración SMTP:
Gmail / Google Workspace
MAIL_DRIVER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=tu-email@gmail.com
MAIL_PASSWORD=tu-app-password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDR=tu-email@gmail.com
MAIL_FROM_NAME="Snipe-IT"
Office 365
MAIL_DRIVER=smtp
MAIL_HOST=smtp.office365.com
MAIL_PORT=587
MAIL_USERNAME=tu-email@tuempresa.com
MAIL_PASSWORD=tu-contraseña
MAIL_ENCRYPTION=tls
Después de cambiar la configuración, reinicia:
docker compose restart app
Gestión y mantenimiento
Ver logs
docker compose logs -f
docker compose logs -f app
Acceder al shell del contenedor
docker compose exec app bash
Reiniciar Snipe-IT
docker compose restart app
Detener todo
docker compose down
Actualizar Snipe-IT
docker compose pull
docker compose up -d
Backup y restore
Backup de base de datos
docker compose exec db mysqldump -u snipeit -p snipeit \
> snipeit-backup-$(date +%Y%m%d).sql
Backup de archivos subidos
Los archivos (imágenes, documentos adjuntos) están en el volumen storage:
docker run --rm \
-v snipeit_storage:/data \
-v $(pwd):/backup \
alpine tar czf /backup/snipeit-storage-$(date +%Y%m%d).tar.gz -C /data .
Restore de base de datos
cat snipeit-backup-20260501.sql | \
docker compose exec -T db mysql -u snipeit -p snipeit
Backup automatizado desde la UI
Snipe-IT incluye backup integrado:
- Ve a Settings → Backups
- Configura backups automáticos diarios/semanales
- Los backups se guardan en
/var/lib/snipeit/dumps
Integración con LDAP/Active Directory
Desde la interfaz web:
- Ve a Settings → LDAP Sync & Login
- Habilita LDAP
- Configura:
- Server:
ldap://tu-servidor.com o ldaps:// para SSL
- Port:
389 (o 636 para LDAPS)
- Base DN:
DC=empresa,DC=com
- Bind Username y Password para cuenta de servicio
- Filter:
(objectClass=user)
- Prueba la conexión
- Configura sincronización de usuarios si lo deseas
Etiquetas QR y códigos de barras
Snipe-IT genera automáticamente códigos QR para cada activo.
Generar etiquetas
- Ve a Hardware → View All
- Selecciona los activos que quieres etiquetar (checkbox)
- Haz clic en Actions → Generate Labels
- Descarga el PDF con las etiquetas
- Imprime en papel de etiquetas adhesivas
Escanear con móvil
Descarga la app móvil oficial de Snipe-IT:
- iOS: Busca "Snipe-IT" en App Store
- Android: Busca "Snipe-IT" en Google Play
Escanea códigos QR para check-in/out rápido de activos.
Campos personalizados
Añade campos adicionales específicos de tu organización:
- Ve a Settings → Custom Fields
- Haz clic en Create New
- Define:
- Nombre del campo
- Tipo (texto, lista, fecha, URL, checkbox, etc.)
- Conjunto de campos (para agrupar campos relacionados)
- Si es obligatorio
- Si debe ser único
- Si debe estar encriptado (para datos sensibles)
- Asigna el conjunto de campos a modelos de activos
Usar la API REST
Snipe-IT incluye una API REST completa para automatización.
Generar token de API
- Ve a tu perfil de usuario (esquina superior derecha)
- Selecciona Manage API Keys
- Genera un nuevo token
- Guárdalo de forma segura (solo se muestra una vez)
Ejemplo de uso
curl -X GET "http://localhost:8000/api/v1/hardware" \
-H "Accept: application/json" \
-H "Authorization: Bearer TU-TOKEN-AQUI"
curl -X POST "http://localhost:8000/api/v1/hardware" \
-H "Accept: application/json" \
-H "Authorization: Bearer TU-TOKEN-AQUI" \
-H "Content-Type: application/json" \
-d '{
"asset_tag": "LAPTOP001",
"model_id": 1,
"status_id": 2,
"assigned_to": 5
}'
Documentación completa de la API en: http://localhost:8000/api/docs
Casos de uso
- Departamentos de IT: Seguimiento de computadoras, monitores, teléfonos asignados a empleados
- Empresas pequeñas: Inventario completo de hardware sin costes de licencias
- Universidades: Gestión de equipos prestados a estudiantes y profesores
- Bibliotecas: Control de dispositivos electrónicos en préstamo
- Talleres: Inventario de herramientas y equipamiento con check-in/out
- Auditorías ISO/SOC2: Reportes de cumplimiento con historial completo de activos
- Gestión de licencias: Control de licenses de software con alertas de renovación
Sígueme en mis redes sociales
Comentarios
Publicar un comentario