Català: Aquesta pàgina no està traduida encara al català.
Castellano: Esta página no está traducida aún al castellano.

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)>
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 spice viewer connections are stored here. You can also replace initial self-signed certificates with your commercial/letsencrypt ones following the documentation guide about replacing certificates. In the actual version IsardVDI website and web viewers make use of the same certificates stored at /opt/isard/certs/default/ path location and spice should use a self-signed certificate autogenerated at /opt/isard/certs/viewer/.
/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¶

Ubuntu 22¶

To install docker and docker compose you'll need only to install docker as compose is now integrated:

sudo apt-get remove docker docker-engine docker.io containerd runc curl
sudo apt-get update
sudo apt-get install -y \
    ca-certificates \
    curl \
    gnupg \
    lsb-release
sudo mkdir -m 0755 -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl status docker

NOTE: This installations are kept here only for reference as they are a bit outdated.

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: July 7, 2023