Skip to content

Insights

Mapped paths

IsardVDI will create following paths on your system and map it inside hypervisor and app containers:

  • /opt/isard: The main folder that will contain:
  • bases: Path where base template images will be stored. The complete path will include /opt/isard/bases/<role>/<category>/<group>/<username>/<base_disk_name.qcow2>
  • templates: Path where user template images will be stored. The complete path will include /opt/isard/templates/<role>/<category>/<group>/<username>/<tmpl_disk_name.qcow2>
  • groups: Path where desktop runnable images will be stored. The complete path will include /opt/isard/group/<role>/<category>/<group>/<username>/<desktop_disk_name.qcow2>
  • media: Path where media (iso and floppy files) will be uploaded. The complete path will include /opt/isard/media/<role>/<category>/<group>/<username>/<media_(iso|floppy).(iso|fd)>
  • backups: Database backups created in web interface using the backup config menu will be stored here.
  • uploads: (work in progress)
  • logs: Here you will have logs for all the containers. Be aware they could grow so they should be rotated/deleted programatically.
  • certs: Certificates for web UI and viewer connections are stored here. Also you can replace initial self-signed certificates with your commercial/letsencrypt ones following the documentation guide about replacing certificates. In the actual version IsardVDI website and viewers make use of the same certificates stored at /opt/isard/certs/default/ path location.
  • /opt/isard-local: Logs and sockets from containers.

Build your docker images

If you prefer to build your IsardVDI alpine based docker images you have to clone the full repository (git clone https://gitlab.com/isard/isardvdi.git) and you will find the docker sources under docker folder:

After building images from source you can start it with docker-compose up -d.

NOTE: Check the version of containers in docker-compose.yml file to build the same version.

Sample installs

Debian 9 Stretch

With a fresh debian 9 install you can install docker and docker-compose with this commands.

Install docker

apt-get remove docker docker-engine docker.io containerd runc
apt-get install     apt-transport-https     ca-certificates     curl     gnupg2     software-properties-common
curl -fsSL https://download.docker.com/linux/debian/gpg | apt-key add -
add-apt-repository    "deb [arch=amd64] https://download.docker.com/linux/debian \
   $(lsb_release -cs) \
   stable"
apt-get update
apt-get install docker-ce

Install docker-compose

apt install python3-pip
pip3 install docker-compose

Fedora 28-29

With a fresh Fedora 28-29 install you can install docker and docker-compose with this commands.

Install docker

sudo dnf remove docker \
                  docker-client \
                  docker-client-latest \
                  docker-common \
                  docker-latest \
                  docker-latest-logrotate \
                  docker-logrotate \
                  docker-selinux \
                  docker-engine-selinux \
                  docker-engine

sudo dnf -y install dnf-plugins-core
sudo dnf config-manager \
    --add-repo \
    https://download.docker.com/linux/fedora/docker-ce.repo
sudo dnf install docker-ce docker-ce-cli containerd.io -y
sudo systemctl start docker
sudo systemctl enable docker

Install docker-compose

yum install python3-pip
pip3 install docker-compose

Last update: April 18, 2023