Linux (recommandé)

Ces instructions s’adressent à la personne qui administre l’instance, généralement avec un profil plus technique et opérationnel.

Prérequis (Ubuntu)

1. Installez les dépendances :

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

1. Ajoutez votre utilisateur au groupe Docker :

sudo usermod -aG docker $USER

1. Déconnectez-vous puis reconnectez-vous pour appliquer l’autorisation du groupe.

Remarque :

• Si vous n’avez pas les droits root, utilisez sudo lorsque c’est nécessaire.

Installation

1. Téléchargez le dépôt et entrez dans le dossier :

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

1. Démarrez Farinha :

./run.sh

Lors de la première exécution, run.sh crée automatiquement le fichier .env à partir de .env-sample.

Le script demande également l’URL publique de Farinha. Si vous ne la connaissez pas encore, appuyez sur Enter pour la laisser vide et continuer. Vous pourrez modifier .env plus tard.

La SECRET_KEY est générée automatiquement, sans dépendre de Django installé sur le serveur. La clé automatique ne contient pas $.

Si vous créez une SECRET_KEY manuellement et qu’elle contient $, le script avertira que Docker Compose peut interpréter ce caractère comme une variable d’environnement et proposera de générer une nouvelle clé sûre.

Ajustement manuel facultatif

Si vous devez vérifier ou modifier la configuration, ouvrez .env avec votre éditeur de texte préféré :

nano .env

Mise à jour

1. Entrez dans le dossier où Farinha a été installé :

cd farinha

1. Arrêtez, mettez à jour et redémarrez :

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