This project provides two helper scripts to automate the process of creating customized VM images and launching virtual machines using QEMU/KVM, cloud-init, and tmux.

Make sure the following tools are installed:

• QEMU/KVM
• cloud-utils (for cloud-localds)
• tmux (for session management)

On Ubuntu/Debian:

sudo apt update
sudo apt install -y qemu-kvm cloud-utils genisoimage tmux

1. Use create_vm_image.sh to build a VM image + cloud-init.iso.
2. Use launch_vm.sh to boot the VM inside tmux.
3. SSH into the VM using the forwarded port (user networking).

# Step 0: Create a ./img directory, and download a Ubuntu cloud image
mkdir img
pushd img
wget https://cloud-images.ubuntu.com/releases/plucky/release/ubuntu-25.04-server-cloudimg-amd64.img
popd

# Step 1: Create VM image
./create_vm_image.sh -b ./img/ubuntu-25.04-server-cloudimg-amd64.img -n ubuntu25_vm.img -u testuser -s 64G

# Step 2: Launch VM in tmux
./launch_vm.sh -i ubuntu25_vm.img -p 2020 -c 4 -m 4 -t ubuntu25-vm -C cloud-init.iso

# Step 3: SSH into VM
ssh testuser@localhost -p 2222

Creates a new VM disk image from a base Ubuntu cloud image, applies cloud-init configuration (hostname, username, password), and generates an ISO for bootstrapping.

./create_vm_image.sh -b <base_image> -n <new_image> -h <hostname> -u <username> -p <password> -s <disk_size>

• -b: Path to the base image (default: ./img/jammy-server-cloudimg-amd64.img)
• -n: Name of the new VM image (default: custom_vm_image.img)
• -h: VM hostname (default: VM)
• -u: VM username (default: ubuntu)
• -p: VM password (default: ubuntu)
• -s: VM disk size (default: 10G)

./create_vm_image.sh -n myvm.img -h myhost -u alice -p secret123 -s 20G

This will:

1. Create a myvm.img disk (20G).
2. Set the hostname to myhost.
3. Create a user alice with password secret123.
4. Generate cloud-init.iso for first-boot configuration.

Launches a VM inside a tmux session for easier management. Supports both user networking (with SSH port forwarding) and tap networking (for bridged connections).

./launch_vm.sh -i <vm_image> -c <vcpu> -m <memory> -p <host_port> \
  [-C <cloud_init_image>] [-t <tmux_session_name>] \
  [-n <network_type>] [-T <tap_interface>]

• -i: Path to the VM image (required)
• -c: Number of vCPUs (default: 2)
• -m: Memory size in GB (default: 2)
• -p: Host port forwarded to guest SSH port 22 (default: 2222)
• -C: Optional path to a cloud-init ISO (e.g., cloud-init.iso)
• -t: Tmux session name (default: vm-session)
• -n: Network type: user or tap (default: user)
• -T: TAP interface name if using -n tap (default: tap0)

Basic launch with user networking:

./launch_vm.sh -i myvm.img -c 2 -m 4 -p 2200 -t vm1

• Starts the VM with 2 CPUs, 4GB RAM.
• Forwards host port 2200 → guest port 22.
• Runs inside tmux session vm1.
• Connect with:

ssh alice@localhost -p 2200

sudo ./launch_vm.sh -i myvm.img -c 4 -m 8 -n tap -T tap0 -t vm-tap

• Starts the VM with 4 CPUs, 8GB RAM.
• Uses tap device tap0 for bridged networking.
• Runs inside tmux session vm-tap.