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.

El script también pregunta cuál será la URL pública de Farinha. Si aún no la sabe, presione Enter para dejarla en blanco y continuar. Podrá editar .env después.

La SECRET_KEY se genera automáticamente, sin depender de Django instalado en el servidor. 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.

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