Sari la conținut

Linux (recomandat)

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

Cerințe preliminare (Ubuntu)

  1. Instalați dependențele:
sudo apt update && sudo apt install -y git docker.io docker-compose-plugin
  1. Adăugați utilizatorul dvs. în grupul Docker:
sudo usermod -aG docker $USER
  1. Deconectați-vă și autentificați-vă din nou pentru a aplica permisiunea grupului.

Observație:

  • Dacă nu aveți permisiuni root, folosiți sudo când este necesar.

Instalare

  1. Descărcați depozitul și intrați în folder:
git clone https://gitlab.com/yndexa/farinha.git
cd farinha
  1. Porniți Farinha:
./run.sh

La prima execuție, run.sh:

  • 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ă, fără a depinde de Django instalat pe server;
  • creează un utilizator administrator admin cu parolă aleatorie, afișată în consolă o singură dată. Notați parola înainte de a închide terminalul.

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

Pentru a determina ce mediu va fi folosit (dezvoltare sau producție), scriptul citește variabila ENV din .env. .env-sample vine cu ENV=prod și DEBUG=False, valori adecvate pentru o instalare reală.

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).

Ajustare manuală opțională

Dacă trebuie să verificați sau să modificați configurările, deschideți .env cu editorul de text preferat:

nano .env

Actualizare

  1. Intrați în folderul unde a fost instalat Farinha:
cd farinha
  1. Opriți, actualizați și porniți din nou:
./down.sh && git pull && ./run.sh

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

  • „permission denied” la folosirea Docker: utilizatorul dvs. nu este în grupul Docker. Rulați sudo usermod -aG docker $USER și deconectați-vă/autentificați-vă din nou (sau folosiți sudo, când este cazul).
  • 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.