Saltar a contenido

Linux (recomendado)

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

Requisitos previos (Ubuntu)

  1. Instale las dependencias:
sudo apt update && sudo apt install -y git docker.io docker-compose-plugin
  1. Agregue su usuario al grupo de Docker:
sudo usermod -aG docker $USER
  1. Cierre sesión y vuelva a entrar para aplicar el permiso del grupo.

Nota:

  • Si no tiene permisos de root, use sudo cuando sea necesario.

Instalación

  1. Descargue el repositorio y entre en la carpeta:
git clone https://gitlab.com/yndexa/farinha.git
cd farinha
  1. Inicie Farinha:
./run.sh

En la primera ejecución, run.sh:

  • 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, sin depender de Django instalado en el servidor;
  • crea un usuario administrador admin con contraseña aleatoria, mostrada en la consola solo una vez. Anote la contraseña antes de cerrar el terminal.

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

Para saber qué entorno se usará (desarrollo o producción), el script lee la variable ENV del .env. El .env-sample viene con ENV=prod y DEBUG=False, valores adecuados para una instalación real.

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).

Ajuste manual opcional

Si necesita revisar o cambiar la configuración, abra .env con su editor de texto preferido:

nano .env

Actualización

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

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

  • "permission denied" al usar Docker: su usuario no está en el grupo de Docker. Ejecute sudo usermod -aG docker $USER y cierre/abra sesión (o use sudo, cuando corresponda).
  • 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.