Acest ghid explică instalarea versiunii server (self-hosted) Oppia pe Ubuntu 24.04, folosind Node.js, Python și dependențele necesare.

⚠️ Oppia necesită resurse decente (minim 4 GB RAM recomandat).

🔧 1️⃣ Actualizare sistem

sudo apt update
sudo apt upgrade -y

📦 2️⃣ Instalare dependențe esențiale

sudo apt install git python3 python3-pip python3-venv \
build-essential unzip curl -y

🟢 3️⃣ Instalare Node.js (versiunea recomandată LTS)

Oppia funcționează cel mai bine cu Node LTS.

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs -y

Verificare:

node -v
npm -v

📥 4️⃣ Descărcare cod Oppia

Clonează repository-ul oficial:

cd /home
sudo git clone https://github.com/oppia/oppia.git
sudo chown -R $USER:$USER oppia
cd oppia

⚙ 5️⃣ Instalare automată dependențe

Oppia include un script automat de setup:

python3 -m pip install --user -r requirements.txt
python3 -m scripts.install_third_party_libs

Instalează dependențele Node:

npm install

🚀 6️⃣ Pornire în mod dezvoltare (test local)

python3 -m scripts.start

Accesează în browser:

http://localhost:8181

🏗 7️⃣ Configurare pentru producție

Pentru rulare stabilă pe server:

Creează utilizator dedicat

sudo adduser oppia
sudo chown -R oppia:oppia /home/oppia

Folosește PM2 pentru rulare persistentă

sudo npm install -g pm2
pm2 start "python3 -m scripts.start" --name oppia
pm2 startup
pm2 save

🌐 8️⃣ Configurare Reverse Proxy cu Apache

Instalează Apache:

sudo apt install apache2 -y

Activează modulele proxy:

sudo a2enmod proxy proxy_http rewrite

Creează VirtualHost:

sudo nano /etc/apache2/sites-available/oppia.conf

Adaugă:

<VirtualHost *:80>
    ServerName invata.exemplu.ro

    ProxyPreserveHost On
    ProxyPass / http://localhost:8181/
    ProxyPassReverse / http://localhost:8181/

    ErrorLog ${APACHE_LOG_DIR}/oppia_error.log
    CustomLog ${APACHE_LOG_DIR}/oppia_access.log combined
</VirtualHost>

Activează:

sudo a2ensite oppia.conf
sudo systemctl reload apache2

🔐 9️⃣ Activare HTTPS

sudo apt install certbot python3-certbot-apache -y
sudo certbot --apache

🔥 🔒 Configurare Firewall

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

📊 1️⃣0️⃣ Creare cont administrator

După prima accesare:

Creează cont nou
Promovează-l la rol de admin din interfață
Configurează setările globale

🧠 Recomandări pentru producție reală

✔ Folosește minim 8 GB RAM pentru utilizare intensă
✔ Configurează backup periodic
✔ Activează cache (Redis) pentru performanță
✔ Rulează prin Nginx (mai performant decât Apache)
✔ Monitorizează cu pm2 monit

✅ Concluzie

Instalarea Oppia pe Ubuntu 24.04 îți oferă o platformă puternică pentru crearea de lecții interactive personalizate. Este ideală pentru:

Școli
ONG-uri
Platforme educaționale
Training intern

Software Open Source pentru Educație și Biblioteci

📘 Ghid de instalare Oppia pe Ubuntu 24.04 LTS