Instalación con Docker

Requisitos

• Docker 24+ y Docker Compose v2
• 512 MB RAM mínimo (recomendado 1 GB)
• Puerto 8080 disponible

Consejo

Si aún no tienes Docker instalado en Linux:

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

Cierra sesión y vuelve a entrar para que el grupo surta efecto.

Pasos

1. Clonar el repositorio

git clone https://github.com/Antjrobles/LocalGuard.git
cd LocalGuard

2. Crear el archivo .env

cp .env.example .env

Edita .env y configura al menos:

LG_JWT_SECRET=tu_cad...eres
LG_MODE=standalone

Consejo

Genera un secreto seguro con: openssl rand -base64 32

3. Arrancar

docker compose up -d

El primer arranque descarga la imagen y construye los contenedores (~2-3 minutos).

4. Acceder al panel

Abre http://localhost:8080 en tu navegador. En el primer arranque se te pedirá crear el usuario administrador.

Acceso desde otros dispositivos

Para acceder al panel desde otros dispositivos de tu red, usa la IP de la máquina donde corre Docker en lugar de localhost. Ejemplo: http://192.168.1.10:8080.

Configuración de red recomendada

Para que los agentes Windows siempre puedan conectarse al servidor, asigna una IP fija a la máquina donde corre Docker:

1. Entra al panel de tu router → DHCP → Reservas
2. Asigna una IP fija a la MAC de tu servidor (ej. 192.168.1.10)
3. Al instalar el agente Windows, usa esa IP: http://192.168.1.10:8080

Actualizar

git pull
docker compose up -d --build

Detener

docker compose down

Los datos persisten en ./data/ — no se pierden al detener.

Solución de problemas

Problema	Solución
Puerto 8080 ocupado	Cambia el puerto en docker-compose.yml: "9090:8080"
El contenedor no arranca	Revisa logs: docker compose logs -f
No puedo acceder desde otro PC	Verifica que el firewall permite el puerto 8080
Error de permisos en ./data/	Ejecuta: sudo chown -R $(id -u):$(id -g) ./data/