Vai al contenuto

Windows

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

Prerequisiti (Windows 10/11)

  1. Installare Docker Desktop:

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

  3. Attivare WSL 2 quando richiesto.

  4. Riavviare il PC.

Installazione

  1. Scaricare il repository ed entrare nella cartella usando PowerShell o il terminale preferito:
git clone https://gitlab.com/yndexa/farinha.git
cd farinha
  1. Avviare Farinha usando lo script di Windows:
.\run.bat

Alla prima esecuzione, run.bat:

  • crea automaticamente il file .env a partire da .env-sample;
  • chiede quale sarà l’indirizzo pubblico di Farinha (in portoghese e inglese). Se non lo si conosce ancora, premere Enter per lasciare vuoto il campo e proseguire; sarà possibile modificare .env in seguito;
  • genera una SECRET_KEY sicura;
  • crea un utente amministratore admin con password casuale, mostrata in console una sola volta. Annotare la password prima di chiudere la finestra.

La chiave automatica non contiene $. Se una SECRET_KEY manuale contiene $, lo script avviserà che Docker Compose può interpretare questo carattere come variabile d’ambiente e proporrà di generare una nuova chiave sicura.

HTTPS e certificati

Farinha usa Caddy per servire HTTPS:

  • Con un indirizzo pubblico configurato, i certificati gratuiti vengono ottenuti e rinnovati automaticamente.
  • Per usare certificati propri, inserire fullchain.pem e privkey.pem nella cartella certs, nella radice del progetto.
  • Senza indirizzo pubblico e senza certificati propri (ad esempio, localhost), HTTPS viene disattivato automaticamente.

Vedi i dettagli in Sicurezza e HTTPS, inclusa la variabile DISABLE_HTTPS e la protezione contro i bot (Anubis).

Aggiornamento

  1. Entrare nella cartella in cui Farinha è stato installato:
cd farinha
  1. Arrestare, aggiornare e riavviare:
.\down.bat
git pull
.\run.bat

Se la propria istanza prevede una procedura interna specifica per arrestare/avviare i container, seguire tale procedura prima di aggiornare il repository.

Buone pratiche

  • Annotare la password dell’utente admin mostrata alla prima esecuzione; non viene più visualizzata.
  • Mantenere DEBUG=False nel .env nelle installazioni reali.
  • Fare un backup del database (db) prima degli aggiornamenti e conservare la cartella certs se si usano certificati propri.
  • Preferire l’aggiornamento arrestando e riavviando tutto (down + pull + run), invece di ricreare un solo container.

Problemi comuni

  • “Docker Desktop non è in esecuzione”: avviare Docker Desktop e rieseguire run.bat.
  • Lo script si arresta senza avviarsi: verificare che la SECRET_KEY sia presente nel .env e non contenga $.
  • Ho perso la password dell’utente admin: creare un altro superutente dal terminale, all’interno del container:
docker compose -f docker-compose.prod.yml exec web python manage.py createsuperuser
  • Riesco ad accedere solo via HTTP: con localhost o un IP, HTTPS viene disattivato; configurare un dominio o certificati propri. Vedi Sicurezza e HTTPS.
  • Il pannello interno non si apre su /admin/: qualcuno potrebbe aver modificato ADMIN_PATH nel .env. Vedi Utente SuperAdmin.