Skip to content

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RELT — Relevamiento IT

Version Docker License

Herramienta local y completa para relevamiento de dispositivos tecnológicos. Sin nubes, sin servidores externos. Tus datos quedan en tu máquina.


¿Qué podés relevar?

Dispositivo Datos generales Hardware
Computadora / Notebook IP, MAC, Serie, Ubicación, Usuario CPU, RAM, Disco, GPU, OS
Servidor IP, MAC, Serie CPU, RAM, Disco, OS
Teléfono IP IP, MAC, Modelo —
Celular Serie, Modelo RAM, Disco, OS, Pantalla
Impresora / Scanner IP, MAC, Serie —
Switch / Router / AP IP, MAC, Modelo —
Monitor / Televisor Serie, Modelo Pantalla, OS
Mouse / Teclado / UPS / NAS Serie, Modelo Según aplique

Campos por dispositivo: nombre, tipo, marca, modelo, número de serie, IP, MAC, ubicación, usuario asignado, estado, notas y hardware específico.


Requisitos

Windows

Linux / macOS


Instalación en Windows

1. Instalar Docker Desktop

  1. Descargá Docker Desktop desde https://www.docker.com/products/docker-desktop/
  2. Ejecutá el instalador y seguí los pasos
  3. Reiniciá la PC cuando lo solicite
  4. Abrí Docker Desktop y esperá a que diga "Engine running"

2. Instalar Git

  1. Descargá Git desde https://git-scm.com/download/win
  2. Instalá con todas las opciones por defecto
  3. Abrí Git Bash o PowerShell

3. Clonar y configurar RELT

Abrí PowerShell o Git Bash y ejecutá:

git clone https://github.com/LucD3c/RELT.git
cd RELT
copy .env.example .env

Generá tu clave secreta ejecutando esto en PowerShell:

python -c "import secrets; print(secrets.token_hex(32))"

Si no tenés Python instalado en Windows, podés generar la clave en https://generate-secret.vercel.app/64

Abrí el archivo .env con el Bloc de notas y reemplazá el valor de SECRET_KEY:

SECRET_KEY=pega-aqui-tu-clave-generada

4. Levantar RELT

docker compose up --build

5. Abrir en el navegador

http://localhost

Instalación en Linux (Ubuntu/Debian)

1. Instalar dependencias

sudo apt update && sudo apt install -y git curl

# Instalar Docker
curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER
newgrp docker

2. Clonar y configurar RELT

git clone https://github.com/LucD3c/RELT.git
cd RELT
cp .env.example .env

Generá tu clave secreta:

python3 -c "import secrets; print(secrets.token_hex(32))"

Editá el .env y pegá la clave:

nano .env
# Reemplazá el valor de SECRET_KEY con la clave generada
# Guardá con Ctrl+O y salí con Ctrl+X

3. Levantar RELT

docker compose up --build

O en segundo plano:

docker compose up --build -d

4. Abrir en el navegador

http://localhost

Uso con el script automático (Linux/macOS)

git clone https://github.com/LucD3c/RELT.git
cd RELT
./start.sh

El script genera la clave secreta automáticamente y levanta todo.


Comandos útiles

# Detener RELT
docker compose down

# Ver logs en tiempo real
docker compose logs -f

# Actualizar a nueva versión
git pull origin main
docker compose up --build -d

# Reiniciar sin reconstruir
docker compose restart

¿Dónde se guardan los datos?

En un volumen de Docker llamado relt-data, almacenado localmente en tu máquina. Nunca salen de tu equipo. Para hacer una copia de seguridad:

# Exportar base de datos
docker run --rm -v relt_relt-data:/data -v $(pwd):/backup alpine tar czf /backup/relt-backup.tar.gz /data

Funcionalidades

  • ✅ Registro completo de dispositivos IT
  • ✅ Hardware detallado (CPU, RAM, disco, GPU, OS)
  • ✅ Ping en tiempo real con actualización de estado
  • ✅ Búsqueda por nombre, IP, MAC, usuario
  • ✅ Filtro por tipo de dispositivo
  • ✅ Exportar inventario a Excel (.xlsx)
  • ✅ Datos 100% locales, sin nubes
  • ✅ Compatible con Windows, Linux y macOS

Tecnologías

  • Backend: Python 3.12 + FastAPI + SQLite
  • Frontend: React + Vite + Nginx
  • Contenedor: Docker + Docker Compose

Autor

Desarrollado por LucD3c


⚠️ Nota sobre el Ping

La función de ping requiere que el dispositivo destino tenga habilitada la respuesta a solicitudes ICMP en su firewall.

Windows: Por defecto bloquea el ping. Para habilitarlo, ejecutar en PowerShell como Administrador:

netsh advfirewall firewall add rule name="Allow ICMPv4" protocol=icmpv4:8,any dir=in action=allow

Linux: El ping funciona por defecto sin configuración adicional.

macOS: El ping funciona por defecto sin configuración adicional.

Packages

Contributors

Languages