proxmox-web-portal

A web portal to primarily allow students access to VMs in our proxmox environment

It uses fastapi and mariadb alongside our oauth2 service and our observability stack.

Setup

There is a setup.sh script that installs the dependencies, python3-venv and mariadb-lib, as well as setting up the python venv. It also creates and installs a systemd service called proxmox-web-portal that starts the fastapi server.

Configuration

After running setup you will have an empty config.ini file in your project location that you need to fill out with relevant information.

MariaDB configuration

Access to VMs is handled via MariaDB. The repo includes a schema.sql that can be imported after the database has been setup. Easiest way is to run the following directly in the terminal after the database has been set up

mariadb database < schema.sql