Windows

Aceste instrucțiuni sunt destinate persoanei care administrează instanța, de obicei cu un profil mai tehnic și operațional.

Cerințe preliminare (Windows 10/11)

1. Instalați Docker Desktop:

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

3. Activați WSL 2 când vi se solicită.

4. Reporniți calculatorul.

Instalare

1. Descărcați depozitul și intrați în folder folosind PowerShell sau terminalul preferat:

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

1. Porniți Farinha folosind scriptul Windows:

.\run.bat

La prima execuție, run.bat:

• creează automat fișierul .env din .env-sample;
• întreabă care va fi adresa publică a Farinha (în portugheză și engleză). Dacă nu o cunoașteți încă, apăsați Enter pentru a o lăsa goală și a continua; veți putea edita .env mai târziu;
• generează o SECRET_KEY sigură;
• creează un utilizator administrator admin cu parolă aleatorie, afișată în consolă o singură dată. Notați parola înainte de a închide fereastra.

Cheia automată nu conține $. Dacă o SECRET_KEY manuală conține $, scriptul va avertiza că Docker Compose poate interpreta acest caracter ca variabilă de mediu și va oferi generarea unei noi chei sigure.

HTTPS și certificate

Farinha folosește Caddy pentru a servi HTTPS:

• Cu o adresă publică configurată, certificatele gratuite sunt obținute și reînnoite automat.
• Pentru a folosi certificate proprii, plasați fullchain.pem și privkey.pem în folderul certs, în rădăcina proiectului.
• Fără adresă publică și fără certificate proprii (de exemplu, localhost), HTTPS este dezactivat automat.

Vezi detaliile în Securitate și HTTPS, inclusiv variabila DISABLE_HTTPS și protecția împotriva boților (Anubis).

Actualizare

1. Intrați în folderul unde a fost instalat Farinha:

cd farinha

1. Opriți, actualizați și porniți din nou:

.\down.bat
git pull
.\run.bat

Dacă instanța dvs. are o procedură internă specifică pentru oprirea/pornirea containerelor, urmați acea procedură înainte de a actualiza depozitul.

Bune practici

• Notați parola utilizatorului admin afișată la prima execuție; ea nu mai este afișată din nou.
• Mențineți DEBUG=False în .env în instalările reale.
• Faceți o copie de siguranță a bazei de date (db) înainte de actualizări și păstrați folderul certs dacă folosiți certificate proprii.
• Preferați actualizarea prin oprirea și pornirea întregului stack (down + pull + run), în loc să recreați doar un container.

Probleme comune

• „Docker Desktop nu rulează”: porniți Docker Desktop și rulați din nou run.bat.
• Scriptul se oprește fără a porni: verificați dacă SECRET_KEY există în .env și nu conține $.
• Am pierdut parola utilizatorului admin: creați un alt superutilizator din terminal, în container:

docker compose -f docker-compose.prod.yml exec web python manage.py createsuperuser

• Pot accesa doar prin HTTP: cu localhost sau un IP, HTTPS este dezactivat; configurați un domeniu sau certificate proprii. Vezi Securitate și HTTPS.
• Panoul intern nu se deschide la /admin/: cineva poate a modificat ADMIN_PATH în .env. Vezi Utilizator SuperAdmin.