Saltar a contenido

Windows

Estas instrucciones están dirigidas a la persona que administra la instancia, normalmente con un perfil más técnico-operativo.

Requisitos previos (Windows 10/11)

  1. Instale Docker Desktop:

  2. https://www.docker.com/products/docker-desktop

  3. Active WSL 2 cuando se le solicite.

  4. Reinicie la computadora.

Instalación

  1. Descargue el repositorio y entre en la carpeta usando PowerShell o el terminal de su preferencia:
git clone https://gitlab.com/yndexa/farinha.git
cd farinha
  1. Inicie Farinha usando el script de Windows:
.\run.bat

En la primera ejecución, run.bat:

  • crea automáticamente el archivo .env a partir de .env-sample;
  • pregunta cuál será la dirección pública de Farinha (en portugués e inglés). Si aún no la sabe, presione Enter para dejarla en blanco y continuar; podrá editar el .env después;
  • genera una SECRET_KEY segura;
  • crea un usuario administrador admin con contraseña aleatoria, mostrada en la consola solo una vez. Anote la contraseña antes de cerrar la ventana.

La clave automática no contiene $. Si una SECRET_KEY manual contiene $, el script avisará que Docker Compose puede interpretar ese carácter como una variable de entorno y ofrecerá generar una nueva clave segura.

HTTPS y certificados

Farinha usa Caddy para servir HTTPS:

  • Con una dirección pública configurada, los certificados gratuitos se obtienen y renuevan automáticamente.
  • Para usar certificados propios, coloque fullchain.pem y privkey.pem en la carpeta certs, en la raíz del proyecto.
  • Sin dirección pública y sin certificados propios (por ejemplo, localhost), el HTTPS se deshabilita automáticamente.

Vea los detalles en Seguridad y HTTPS, incluida la variable DISABLE_HTTPS y la protección contra bots (Anubis).

Actualización

  1. Entre en la carpeta donde se instaló Farinha:
cd farinha
  1. Detenga, actualice e inicie nuevamente:
.\down.bat
git pull
.\run.bat

Si su instancia tiene un procedimiento interno específico para detener/iniciar contenedores, siga ese procedimiento antes de actualizar el repositorio.

Buenas prácticas

  • Anote la contraseña del usuario admin mostrada en la primera ejecución; no se vuelve a mostrar.
  • Mantenga DEBUG=False en el .env en instalaciones reales.
  • Haga copia de seguridad de la base de datos (db) antes de las actualizaciones y guarde la carpeta certs si usa certificados propios.
  • Prefiera actualizar deteniendo e iniciando todo nuevamente (down + pull + run), en lugar de recrear solo un contenedor.

Problemas comunes

  • "Docker Desktop no está en ejecución": inicie Docker Desktop y ejecute run.bat nuevamente.
  • El script se detiene sin iniciar: verifique que la SECRET_KEY esté presente en el .env y no contenga $.
  • Perdí la contraseña del usuario admin: cree otro superusuario desde el terminal, dentro del contenedor:
docker compose -f docker-compose.prod.yml exec web python manage.py createsuperuser
  • Solo puedo acceder por HTTP: con localhost o una IP el HTTPS se deshabilita; configure un dominio o certificados propios. Vea Seguridad y HTTPS.
  • El panel interno no abre en /admin/: alguien puede haber cambiado ADMIN_PATH en el .env. Vea Usuario SuperAdmin.