This the fronted of the APP VDI. You can find the API here.
The documentation below is for the installation of the frontend only. You can find the all documentation here.
Run the following command to install the frontend with systemd:
curl -s -S -L https://raw.githubusercontent.com/AlexTheGeek/VDI/master/install.sh | sh -s --
- Linux : Ubuntu 20.04, Debian 11,12
- Python 3.11.2
- Pip or Pipx : you can even create a virtual environment to run those scripts
- Create a user vdi with the home directory
/home/vdi
- Create a folder
/home/vdi/VDI-APP
for the API and and clone this repository in it
5.1.mkdir -p /home/vdi/VDI-APP
5.2.cd /home/vdi/VDI-APP
5.3.git clone https://github.com/loimax/vdi.git
5.4.cd vdi
- Install the requirements :
pip install -r requirements.txt
- Create a folder /var/log/VDI/API for the logs of the API :
mkdir -p /var/log/VDI/APP
7.1. Set the rights of the user who runs the API (here vdi) on this folder :chown -R vdi:vdi /var/log/VDI/APP
7.2 Create all necessary files for the logs :touch /var/log/VDI/API/access.log /var/log/VDI/API/error.log
- Build the image :
docker build -t vdi-app .
ordocker-compose build
with the docker-compose.yml file. - Change the environment variable
URL_API
to the API domain (ex: https://api.insa-cvl.com) in the docker-compose.yml file. - Run the container :
docker-compose up -d
with the docker-compose.yml file :version: "3.9" services: vdi-app: image: vdi-app:latest container_name: vdi-app ports: - "127.0.0.1:5000:5000" environment: - URL_API=https://api.insa-cvl.com restart: always
- Check the logs :
docker logs vdi-app
ordocker-compose logs -f
- Change the app.config['URL_API'] variable to the API domain (ex: https://api.insa-cvl.com) in the app.py file.
- Create a file
/etc/systemd/system/vdi-app.service
with the following content :[Unit] Description=Gunicorn instance to serve APP VDI After=network.target [Service] User=vdi Group=vdi WorkingDirectory=/home/vdi/VDI-APP Environment="PATH=/home/vdi/.local/bin" ExecStart=/home/vdi/.local/bin/gunicorn --access-logfile /var/log/VDI/APP/access.log --error-logfile /var/log/VDI/APP/error.log --workers 3 --bind 0.0.0.0:5000 app:app [Install] WantedBy=multi-user.target
- Reload the systemd daemon :
systemctl daemon-reload
- Enable the service :
systemctl enable vdi-app.service
- Start the service :
systemctl start vdi-app.service
- Check the status of the service :
systemctl status vdi-app.service