vm-start/README.md

# vm-start

## Description:
script which permit to launch easily some virtual machines via qemu

## Dependencies:

- <u>qemu</u> full installation


## Optionnal Dependencies:
- <u>ssh</u> to have possibility to connect via ssh with the remote_connection.sh script.
- <u>rsp</u> to have possibility to connect via rsp with the remote_connection.sh script.

## Functionnality:

- use of config files [~ok]
- start,create vm reading the config file [ok]
- delete all data related to a vm [ok]
- create a backup or being able to recall the bacup [ok - have to be improved]
- start directly the backup file [ok]
- list all vm already configured [ok]
- print help of version number [ok]
- support options to overrides the config file [ok]
- can support launching vm in uefi mode [ok]
- take option create_disk to know what disk to use when creating a vm. [ok]
- compatible to an extensive network configuration [ok, just need the script to create the network. ethernet_restraint/no_restreint can be used while waiting for this script to appear.]

### Next changes to come
- put the path of the creation disk on the config file
- add vnc support
- read from $XDG_CONFIG_DIR/vm_start/conf, or if it not exist, from ~/.config/vm_start/conf.
- improve the create_disk mecanism, and the init_cdrom in a load command.




## Usage:

### to get some help;

`vm-start --help`

### to list all vm already configured

`vm-start --list `

### to create a new vm

`vm-start <nom_de_la_vm> create --create_disk=<location_of_iso_file>`

you can of course add options like --uefi to tun in uefi mode, or --nproc=<nb_proc> to select a number of processors.

If you go to the conf folder created the first time you launch the script, you will find all configured variables for each of your vm.