layout	page_title	subcategory	description
page	Setup a VM with Proxmox	Guides	This guide will help you set up a proxmox node in VM using virt-manager for a job.

Setup VM with Proxmox to run examples and acceptance tests

Who

Contributors

Motivation

To test changes, it's best to try it on a real proxmox cluster. There is a dedicated make example command that will try to apply changes defined in the example directory. Most resources have their example declarations there. For example, if you add a new resource, you could add a new file with example resource there (ideally after adding tests). If nothing breaks, the apply works fine, new resource is created and all other resources are fine, then the change is likely safe.

But, proxmox node setup can be a tricky task for some contributors.

Preconditions

Be sure to install go and terraform on your system first.

Linux (Debian/Ubuntu) with virt-manager

The goal is to have a proxmox node in a VM using https://virt-manager.org/ for the job. This text assumes some linux knowledge. Tested on Debian 12 bookworm and proxmox VE 8.1. For other distros, with any luck the steps should be similar.

sudo apt-get install virt-manager.
Download a proxmox image from http://download.proxmox.com/iso/, currently the latest is proxmox-ve_8.1-1.iso.
Run virt-manager and "create a new virtual machine", use the file you just downloaded, choose debian as an operating system, leave default network settings.
Give it enough RAM and disk size (the required minimum is unknown for make example though I used 4GB on my 8GB laptop and 30GB disk size with success).
Proceed forward with installation, choose whatever you want for timezone, country, password, domain, email. Don't change other default settings.

After installation, log in using the password from the previous step and root username (it's the proxmox default). Run: ip a to get the assigned ip (this also appears during installation). In my case it is 192.168.122.43.

It may look like this:

root@proxmox:~# ip a
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
    inet 127.0.0.1/8 scope host lo
    valid_lft forever preferred_lft forever
    inet6 ::1/128 scope host noprefixroute
    valid_lft forever preferred_lft forever
2: enp1s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast master vmbr0 state UP group default qlen 1000
    link/ether 52:54:00:b3:22:f5 brd ff:ff:ff:ff:ff:ff
3: vmbr0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000
    link/ether 52:54:00:b3:22:f5 brd ff:ff:ff:ff:ff:ff
    inet 192.168.122.43/24 scope global vmbr0
    valid_lft forever preferred_lft forever
    inet6 fe80::5054:ff:feb3:22f5/64 scope link
    valid_lft forever preferred_lft forever

(Optional) On your computer, there should be a new interface created mapped to the one you see on proxmox. Again ip a:

...

8: virbr0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000
    link/ether 52:54:00:ca:65:49 brd ff:ff:ff:ff:ff:ff
    inet 192.168.122.1/24 brd 192.168.122.255 scope global virbr0
    valid_lft forever preferred_lft forever

...

(Optional) You can SSH into the proxmox node:
```
ssh root@192.168.122.43
```
You can also use a browser and visit the console at https://192.168.122.43:8006.

Create a terraform.tfvars file (it will be a git ignored file) in the example folder with credentials for your new proxmox node.

# example/terraform.tfvars
virtual_environment_username = "root@pam"
virtual_environment_endpoint = "https://192.168.122.43:8006/"
virtual_environment_password = "your password from step 5"

Now you can run make example.
If you see error with proxmox_virtual_environment_file: the datastore "local" does not support content type "snippets"; supported content types are: [backup, iso, vztmpl, import], you need to enable them, see https://registry.terraform.io/providers/bpg/proxmox/latest/docs/resources/virtual_environment_file#snippets.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!