Linux (consigliato)

Queste istruzioni sono rivolte a chi amministra l'istanza (profilo più tecnico-operativo).

Prerequisiti (Ubuntu)

1. Installa le dipendenze:

sudo apt update && sudo apt install -y git docker.io docker-compose-plugin

1. Aggiungi il tuo utente al gruppo Docker:

sudo usermod -aG docker $USER

1. Effettua logout/login per applicare il permesso del gruppo.

Osservazione:

• Se non disponi di permessi di root, usa sudo quando necessario.

Installazione

1. Scarica il repository ed entra nella cartella:

git clone https://gitlab.com/yndexa/farinha.git
cd farinha

1. Avvia Farinha:

./run.sh

Alla prima esecuzione, run.sh crea automaticamente il file .env a partire da .env-sample.

Lo script chiede inoltre quale sarà l'URL pubblico di Farinha. Se ancora non lo conosci, premi Enter per lasciarlo vuoto e proseguire. Potrai modificare .env in seguito.

La SECRET_KEY viene generata automaticamente, senza dipendere da Django installato sul server. La chiave automatica non contiene $.

Se crei manualmente una SECRET_KEY e questa contiene $, lo script avviserà che Docker Compose può interpretare questo carattere come variabile d'ambiente e proporrà di generare una nuova chiave sicura.

Regolazione manuale opzionale

Se devi rivedere o modificare le impostazioni, apri .env con il tuo editor di testo preferito:

nano .env

Aggiornamento

1. Entra nella cartella in cui Farinha è stato installato:

cd farinha

1. Arresta, aggiorna e riavvia:

./down.sh && git pull && ./run.sh