How to Install OpenEduCat on Ubuntu

$ sudo apt update && sudo apt upgrade -y

Note: Always start with a fully updated system.

$ sudo apt install postgresql postgresql-contrib -y
$ sudo systemctl start postgresql
$ sudo systemctl enable postgresql

Note: PostgreSQL 12+ is required for OpenEduCat.

$ sudo -u postgres createuser -s openeducat
$ sudo -u postgres psql -c "ALTER USER openeducat WITH PASSWORD 'your_password';"

Note: Replace your_password with a secure password.

$ sudo apt install wkhtmltopdf -y

Note: Required for PDF report generation.

$ sudo nano /etc/systemd/system/openeducat.service

Note: Create a systemd unit file so OpenEduCat starts automatically on boot and can be managed with systemctl commands. Set the User to the openeducat system account, the WorkingDirectory to /opt/openeducat, and the ExecStart to python3 openeducat-bin with your configuration file. This ensures the application restarts automatically after server reboots or unexpected crashes, which is essential for production deployments.

$ sudo systemctl daemon-reload
$ sudo systemctl enable openeducat
$ sudo systemctl start openeducat

Note: The enable command ensures OpenEduCat starts automatically after a server reboot. The daemon-reload command tells systemd to re-read the unit files after creating the new service. Check the service status with sudo systemctl status openeducat to confirm it is running.

$ sudo apt install nginx -y
$ sudo systemctl enable nginx
$ sudo systemctl start nginx

Note: Configure an Nginx server block to proxy requests from port 80 or 443 to localhost:8069. This provides HTTPS termination, static file caching, and proper connection handling for production use. Use proxy_pass http://127.0.0.1:8069 in your location block and set appropriate proxy headers for X-Forwarded-For and X-Forwarded-Proto. For SSL, use Let's Encrypt with certbot to obtain a free certificate.

$ curl -I http://localhost:8069
$ sudo systemctl status openeducat
$ sudo systemctl status nginx

Note: Confirm that OpenEduCat responds on port 8069 and that both the application and Nginx services are running. Open your browser and navigate to http://your-server-ip to access the OpenEduCat web interface through the Nginx reverse proxy. The default administrator credentials are admin/admin. Change the password immediately after your first login.