Documentación de instalación

• Docker y Docker Compose instalados en el servidor.
• Una IP interna o dominio por donde vas a acceder (ej. 172.16.0.5 o lockar.tuempresa.com).
• Tu clave de licencia (llega por email al comprar, también se puede copiar desde la pantalla de pago).
• Un cliente SMTP para que salgan los emails de recuperación de cuenta (Gmail, SendGrid, Mailgun, lo que uses habitualmente).

Lockar se distribuye como imagen Docker — el contenedor es Linux por dentro siempre, sin importar el sistema operativo del servidor que lo aloja. Eso significa que no hay dos versiones distintas ni cambios de código entre plataformas:

• Servidor Linux (recomendado): soporte nativo, es el camino más simple. Cualquier distribución con Docker (Ubuntu Server, Debian, etc.) sirve.
• Servidor Windows: instalá Docker Desktop (usa WSL2 por debajo) o Docker Engine directamente. Una vez instalado Docker, los pasos de instalación de Lockar son exactamente los mismos que en Linux.

1. Descargá el instalador desde Descargas (necesitás tu clave de licencia para desbloquear el botón de descarga).
2. Descomprimí el archivo en una carpeta del servidor, por ejemplo /opt/lockar (Linux) o C:\lockar (Windows).
3. Copiá .env.example a .env y completá las variables — ver la sección Variables de entorno más abajo.
4. Levantá los contenedores:

   docker compose up -d --build

5. Esperá a que termine (la primera vez instala dependencias y prepara la base de datos, puede tardar un par de minutos).
6. Entrá a la URL configurada en APP_URL desde el navegador.
7. Creá la primera cuenta. Esta es la única vez que el registro está abierto — por seguridad se cierra automáticamente después. Esa primera cuenta queda como usuario maestro.

El docker-compose.yml que viene con el instalador ya trae todo listo: PHP, Apache, y la base de datos SQLite embebida (no hace falta un servidor de base de datos aparte para instalaciones chicas o medianas).

Comandos que vas a usar seguido:

# Levantar / reconstruir
docker compose up -d --build

# Ver logs en vivo
docker compose logs -f app

# Entrar a una terminal dentro del contenedor
docker compose exec app bash

# Correr un comando de Lockar (ej. crear un usuario)
docker compose exec app php artisan lockar:user

# Apagar
docker compose down

Por defecto el contenedor expone el puerto 80 (HTTP) del servidor hacia afuera. Si ya tenés algo corriendo en ese puerto, cambiá el mapeo en docker-compose.yml:

ports:
  - "8080:80"   # accedés por http://tu-servidor:8080

Solo dentro de la empresa: no necesitás abrir nada en el firewall hacia internet. Con que la IP del servidor sea alcanzable desde la red interna alcanza. Configurá:

APP_URL=http://172.16.0.5
USE_SECURE_TUNNEL=false

Accesible desde afuera de la empresa: necesitás un dominio apuntando al servidor y HTTPS (con un reverse proxy tipo Nginx/Caddy, o un túnel como Cloudflare Tunnel). Configurá:

APP_URL=https://lockar.tuempresa.com
USE_SECURE_TUNNEL=true

Una vez que Lockar está instalado y creaste tu cuenta, andá a /licencia dentro de Lockar y pegá la clave que compraste. Se verifica al instante.

Lockar revisa la licencia automáticamente una vez por hora mientras el servidor tenga salida a internet. Si por algún motivo se corta la conexión, sigue funcionando unos días con la última verificación válida (período de gracia) antes de pedir que renueves.

Cuando esté por vencer o venza, te avisamos por email y también vas a ver un aviso arriba de la pantalla en Lockar con un link directo para renovar.

Por seguridad, el registro público se cierra apenas se crea la primera cuenta. Las cuentas siguientes las da de alta un administrador desde la terminal del servidor:

docker compose exec app php artisan lockar:user

La primera cuenta que se crea en una instalación queda como usuario maestro: es el único que puede activar o cambiar la clave de licencia por defecto, y el único que puede darle ese mismo permiso a otra persona (desde /licencia).

El resto de los usuarios pueden usar Lockar con total normalidad — crear contraseñas, armar carpetas compartidas, tablas, notas — tengan o no el permiso de licencia.

Lockar hace un respaldo automático de la base de datos todos los días. Los archivos quedan dentro de la carpeta storage del proyecto — asegurate de que esa carpeta esté incluida en tu propia estrategia de backup del servidor (o copiala periódicamente a otro lado).

1. Descargá la nueva versión desde Descargas.
2. Hacé un backup de la carpeta storage y del archivo .env por las dudas.
3. Reemplazá los archivos del proyecto por los de la nueva versión (sin pisar tu .env).
4. Reconstruí los contenedores: docker compose up -d --build