Aller au contenu

Windows

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

Prérequis (Windows 10/11)

  1. Installez Docker Desktop :

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

  3. Activez WSL 2 lorsque cela vous est demandé.

  4. Redémarrez l’ordinateur.

Installation

  1. Téléchargez le dépôt et entrez dans le dossier avec PowerShell ou le terminal de votre choix :
git clone https://gitlab.com/yndexa/farinha.git
cd farinha
  1. Démarrez Farinha avec le script Windows :
.\run.bat

Lors de la première exécution, run.bat :

  • crée automatiquement le fichier .env à partir de .env-sample ;
  • demande l’adresse publique de Farinha (en portugais et en anglais). Si vous ne la connaissez pas encore, appuyez sur Enter pour la laisser vide et continuer ; vous pourrez modifier .env plus tard ;
  • génère une SECRET_KEY sûre ;
  • crée un utilisateur administrateur admin avec un mot de passe aléatoire, affiché dans la console une seule fois. Notez le mot de passe avant de fermer la fenêtre.

La clé automatique ne contient pas $. Si une SECRET_KEY manuelle 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.

HTTPS et certificats

Farinha utilise Caddy pour servir HTTPS :

  • Avec une adresse publique configurée, les certificats gratuits sont obtenus et renouvelés automatiquement.
  • Pour utiliser vos propres certificats, placez fullchain.pem et privkey.pem dans le dossier certs, à la racine du projet.
  • Sans adresse publique et sans certificats propres (par exemple, localhost), le HTTPS est désactivé automatiquement.

Voir les détails dans Sécurité et HTTPS, y compris la variable DISABLE_HTTPS et la protection contre les bots (Anubis).

Mise à jour

  1. Entrez dans le dossier où Farinha a été installé :
cd farinha
  1. Arrêtez, mettez à jour et redémarrez :
.\down.bat
git pull
.\run.bat

Si votre instance suit une procédure interne spécifique pour arrêter/démarrer les conteneurs, suivez cette procédure avant de mettre à jour le dépôt.

Bonnes pratiques

  • Notez le mot de passe de l’utilisateur admin affiché lors de la première exécution ; il ne s’affiche plus ensuite.
  • Gardez DEBUG=False dans .env pour les installations réelles.
  • Sauvegardez la base de données (db) avant les mises à jour et conservez le dossier certs si vous utilisez vos propres certificats.
  • Préférez une mise à jour en arrêtant et redémarrant tout (down + pull + run), plutôt que de recréer un seul conteneur.

Problèmes courants

  • « Docker Desktop n’est pas en cours d’exécution » : démarrez Docker Desktop et relancez run.bat.
  • Le script s’arrête sans démarrer : vérifiez que la SECRET_KEY est présente dans .env et ne contient pas $.
  • J’ai perdu le mot de passe de l’utilisateur admin : créez un autre superutilisateur depuis le terminal, dans le conteneur :
docker compose -f docker-compose.prod.yml exec web python manage.py createsuperuser
  • Je ne peux accéder qu’en HTTP : avec localhost ou une IP, le HTTPS est désactivé ; configurez un domaine ou vos propres certificats. Voir Sécurité et HTTPS.
  • Le panneau interne ne s’ouvre pas à /admin/ : quelqu’un a peut-être modifié ADMIN_PATH dans .env. Voir Utilisateur SuperAdmin.