Configure the variables file (env_scripts/common.sh).
It is recommended to place this directory in your home folder to avoid libvirt permission issues.
Run the installation script: install.sh

Networking

Two networks are installed when you run install.sh:

Name	Type	DCHP Range	Default route	Host device
vmnetwork	NAT	192.168.100.100 - 254	192.168.100.1	virb1
host-only	Isolated Network	-	-	-

Table 1: Default Available Networks

You can network names changing on env_scripts/common.sh

VM_NETWORK_HOSTONLY="host-only"
VM_USERNAME="user"

You can create a VM with isolated network but an extra interface with NAT network if added, because when guest is initialized, it get updated and some packages are installed (dependend on linux-user-metadata). You can delete NAT interface after VM guest is initialized.

AppArmor exception (if needed)

If AppArmor is blocking libvirtd, disable the profile temporarily:

ln -s /etc/apparmor.d/usr.sbin.libvirtd /etc/apparmor.d/disable/
apparmor_parser -R /etc/apparmor.d/usr.sbin.libvirtd

Command Usage

Command help

NAME
  ./vm_manage.sh

USAGE
    Usage:  ./vm_manage.sh create -n NAME [-b BRIDGE] [-r RAM] [-c VCPUS] [-s DISK] [-v]
            ./vm_manage.sh delete NAME
            ./vm_manage.sh info NAME
            ./vm_manage.sh connect NAME
            ./vm_manage.sh install NAME
            ./vm_manage.sh list

ACTIONS
  create     Create a new virtual machine
  delete     Delete a virtual machine
  list       List all defined virtual machines
  info       Show information about a virtual machine
  connect    Connect to the console of a virtual machine
  install    Install specific software into an existing VM

OPTIONS
  -h         Show this help message
  -n NAME    Host name (required)
  -b BRIDGE  Bridge interface name
  -r RAM     RAM in MB (default: 1024)
  -c VCPUS   Number of VCPUs (default: 1)
  -s DISK    Disk size in GB (default: 10)
  -v         Verbose mode
  
AUTHOR
  Victor Gracia Enguita <victor@burufalla.ovh>

COPYRIGHT
  This is free software; see the source for copying conditions.

Create VM

Using default values:

./vm_manage.sh create -ntestMachine

Note: Default values can be customized in the env_scripts/common.sh file.

With custom specifications:

./vm_manage.sh create -ntestMachine -r4098 -c4 -s100

This creates a VM with 4096 MB of RAM, 4 vCPUs, and 100 GB of disk space.

List VMs

./vm_manage.sh list
 Id   Nombre       Estado
-------------------------------
 7    debianTest   ejecutando
 8    ubuntuTest   ejecutando

Connect to an VM

./vm_manage.sh connect debianTest

Get ip of VM

./vm_manage.sh info ubuntuTest
192.168.122.234

Delete VMs

Use as parameter machine name

./vm_dmanage.sh delete ubuntuTest
Are you sure you want to remove the VM 'ubuntuTest' (y/N)? y
Domain 'ubuntuTest' destroyed

Domain 'ubuntuTest' has been undefined

VM 'ubuntuTest' removed successfully.

Install software on VM

./vm_manage.sh install VM_NAME

Example:

./vm_manage.sh install Debian
Select software to install:
--------------
 1. Docker
 2. Podman
 3. Gitlab CE
 4. Gitlab Runner
Enter your choice [1-4]:

TODO

Maybe add more BSD flavours guests support
add non debian linux derivatives guests support