libretime/README.docker.md

Ejecutar LibreTime en macOS con Docker Desktop

Pasos rápidos para desarrollo local usando Docker Desktop en macOS:

1. Instalar Docker Desktop (si no está instalado)

brew install --cask docker
open --background -a Docker
# Espera a que Docker inicie (arriba a la derecha aparece el icono)

2. Asignar recursos en Docker Desktop: al menos 2 CPUs y 4 GB RAM

3. Copiar .env.example a .env y editar contraseñas/variables

cp .env.example .env
# Edita .env y asigna contraseñas seguras para POSTGRES_PASSWORD y RABBITMQ_DEFAULT_PASS

4. Levantar el stack (usando el compose preparado para EasyPanel que es env-driven):

docker compose -f docker-compose.easypanel.yml up -d

5. Verificar estado y logs:

docker compose -f docker-compose.easypanel.yml ps
docker compose -f docker-compose.easypanel.yml logs -f config-generator
docker compose -f docker-compose.easypanel.yml logs -f api

6. Si necesitas entrar al contenedor para correr migraciones:

docker compose -f docker-compose.easypanel.yml exec api python manage.py migrate --noinput
docker compose -f docker-compose.easypanel.yml exec api python manage.py createsuperuser

Notas específicas macOS:

• Usa volúmenes nombrados (ya configurado en el compose) para evitar I/O lento por bind mounts.
• Si el contenedor muestra errores relacionados con recursos, aumenta CPU/RAM en Docker Desktop.