<commit_before># Isard**VDI**

<img align="right" src="webapp/webapp/webapp/static/img/isard.png" alt="IsardVDI Logo" width="150px;">

[![](https://img.shields.io/github/release/isard-vdi/isard.svg)](https://github.com/isard-vdi/isard/releases) [![](https://img.shields.io/badge/docker--compose-ready-blue.svg)](https://github.com/isard-vdi/isard/blob/master/docker-compose.yml) [![](https://img.shields.io/badge/docs-latest-brightgreen.svg)](https://isardvdi.readthedocs.io/en/latest/) [![](https://img.shields.io/badge/license-AGPL%20v3.0-brightgreen.svg)](https://github.com/isard-vdi/isard/blob/master/LICENSE)

Open Source KVM Virtual Desktops based on KVM Linux and dockers. 

- Engine that monitors hypervisors and domains (desktops)

- Websocket user interface with real time events.

- HTML5 and native SPICE client viewers

  **IMPORTANT NOTE**: You cannot migrate from the version 1 to version 2, since there are many structural changes. You should backup your XML definition files and QCOW disks and import them in the new version.

# Documentation

Follow the extensive documentation to get the most of your installation:

- [https://isardvdi.readthedocs.io/en/develop/](https://isardvdi.readthedocs.io/en/develop/)

## Quick Start with docker & docker-compose

### 1) *INSTALL docker & docker-compose*
- https://docs.docker.com/install/
- https://docs.docker.com/compose/install/

### 2) **Pull images and bring it up**:

```
wget https://raw.githubusercontent.com/isard-vdi/isard/master/docker-compose.yml.example
docker-compose -f docker-compose.yml.example pull
docker-compose -f docker-compose.yml.example up -d
```

Connect to **https://<ip|domain>**/isard-admin with default user *admin* and password *<PASSWORD>*

NOTE: 

- All data will be created in your host /opt/isard folder
- Logs will be at /opt/isard-local

## Custom build

There is an **isardvdi.cfg.example** file that you can copy to **isardvdi.cfg** and edit to fit your requirements. After that you can create your own *docker-compose.yml* file from that config by issuing *build.sh* script.

Then bring it up with **docker-compose up -d**

Please read the [documentation](https://isardvdi.readthedocs.io/en/develop/install/install/#main-parameters) to configure your IsardVDI installation

### Desktops

You can directly go to *Updates* menu and download and test precreated desktops.
<commit_msg>Use docker-compose instructions as in the web<commit_after># Isard**VDI**

<img align="right" src="webapp/webapp/webapp/static/img/isard.png" alt="IsardVDI Logo" width="150px;">

[![](https://img.shields.io/github/release/isard-vdi/isard.svg)](https://github.com/isard-vdi/isard/releases) [![](https://img.shields.io/badge/docker--compose-ready-blue.svg)](https://github.com/isard-vdi/isard/blob/master/docker-compose.yml) [![](https://img.shields.io/badge/docs-latest-brightgreen.svg)](https://isardvdi.readthedocs.io/en/latest/) [![](https://img.shields.io/badge/license-AGPL%20v3.0-brightgreen.svg)](https://github.com/isard-vdi/isard/blob/master/LICENSE)

Open Source KVM Virtual Desktops based on KVM Linux and dockers. 

- Engine that monitors hypervisors and domains (desktops)

- Websocket user interface with real time events.

- HTML5 and native SPICE client viewers

  **IMPORTANT NOTE**: You cannot migrate from the version 1 to version 2, since there are many structural changes. You should backup your XML definition files and QCOW disks and import them in the new version.

# Documentation

Follow the extensive documentation to get the most of your installation:

- [https://isardvdi.readthedocs.io/en/develop/](https://isardvdi.readthedocs.io/en/develop/)

## Quick Start with docker & docker-compose

### 1) *INSTALL docker & docker-compose*
- https://docs.docker.com/install/
- https://docs.docker.com/compose/install/

### 2) **Pull images and bring it up**:

```
wget https://isardvdi.com/docker-compose.yml
docker-compose pull
docker-compose up -d
```

Connect to **https://<ip|domain>**/isard-admin with default user *admin* and password *<PASSWORD>*

NOTE: 

- All data will be created in your host /opt/isard folder
- Logs will be at /opt/isard-local

## Custom build

There is an **isardvdi.cfg.example** file that you can copy to **isardvdi.cfg** and edit to fit your requirements. After that you can create your own *docker-compose.yml* file from that config by issuing *build.sh* script.

Then bring it up with **docker-compose up -d**

Please read the [documentation](https://isardvdi.readthedocs.io/en/develop/install/install/#main-parameters) to configure your IsardVDI installation

### Desktops

You can directly go to *Updates* menu and download and test precreated desktops.

{'fraction_non_alphanumeric': 0.1378355347251811, 'fraction_numerical': 0.0051129100979974435, 'mean_word_length': 4.51056338028169, 'pattern_counts': {'":': 0, '<': 9, '<?xml version=': 0, '>': 9, 'https://': 30, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1131944', 'n_tokens_mistral': 1639, 'n_tokens_neox': 1509, 'n_words': 428}