docs: proxmoxve: add promoxve install doc by bitdriftr · Pull Request #337 · flatcar/flatcar-website

bitdriftr · 2024-06-04T15:37:43Z

This PR adds Promox VE install doc for upcoming promoxve OEM release.

It explains how to create a VM using the provided image, and how to configure it using either cloud init or Ignition.

tormath1 · 2024-06-06T09:23:39Z

content/docs/latest/installing/vms/proxmoxve.md

+```bash
+# THIS IS A DEVELOPMENT BUILD
+# TODO: update link with an alpha build
+wget http://bincache.flatcar-linux.net/images/amd64/9999.0.102+kai-proxmox-support/flatcar_production_proxmoxve_image.img.bz2 | bzip2 -d > flatcar_production_proxmoxve_image.img


I will check to directly provide uncompressed image. The benefit is not that important:

$ du --si flatcar_production_proxmoxve_image.img 548M flatcar_production_proxmoxve_image.img $ du --si flatcar_production_proxmoxve_image.img.bz2 546M flatcar_production_proxmoxve_image.img.bz2

Now done.

Suggested change

wget http://bincache.flatcar-linux.net/images/amd64/9999.0.102+kai-proxmox-support/flatcar_production_proxmoxve_image.img.bz2 | bzip2 -d > flatcar_production_proxmoxve_image.img

wget http://bincache.flatcar-linux.net/images/amd64/9999.0.102+kai-proxmox-support/flatcar_production_proxmoxve_image.img

content/docs/latest/installing/vms/proxmoxve.md

fhemberger

Complete process for me:

curl -sS http://bincache.flatcar-linux.net/images/amd64/9999.9.100+kai-proxmox-support/flatcar_production_proxmoxve_image.img.bz2 | bzip2 -d > flatcar_production_proxmoxve_image.img

export VM_ID=123
qm create $VM_ID --cores 2 --memory 4096 --net0 "virtio,bridge=vmbr0" --ipconfig0 "ip=dhcp"

# On my Proxmox "out-of-the-box" installation, images are stored on `local-lvm` instead of `local`
qm disk import $VM_ID flatcar_production_proxmoxve_image.img local-lvm

qm set $VM_ID --scsi0 local-lvm:vm-$VM_ID-disk-0
qm set $VM_ID --boot order=scsi0

# Create the cloud-init CD-ROM drive which activates the cloud-init options for the VM.
qm set $VM_ID --ide2 local-lvm:cloudinit

# SKIPPED MANUAL STEP: paste iginition config into /var/lib/vz/snippets/user-data

qm set $VM_ID --cicustom "user=local:snippets/user-data"

fhemberger · 2024-10-25T08:01:03Z

content/docs/latest/installing/vms/proxmoxve.md

+```bash
+# THIS IS A DEVELOPMENT BUILD
+# TODO: update link with an alpha build
+wget http://bincache.flatcar-linux.net/images/amd64/9999.0.102+kai-proxmox-support/flatcar_production_proxmoxve_image.img.bz2 | bzip2 -d > flatcar_production_proxmoxve_image.img


wget | bzip2 -d > … pipes the output from wget itself to bzip, not the downloaded file (that would be wget -O - ), replacing wget with curl would be better.

fhemberger · 2024-10-25T08:30:19Z

content/docs/latest/installing/vms/proxmoxve.md

+In order to create a VM with our image we'll need to use the command line. Open a shell on the hypervisor, download the image and convert it to RAW :
+
+```bash
+qemu-img convert -f qcow2 -O raw flatcar_production_proxmoxve_image.img flatcar_production_proxmoxve_image.bin


Converting the image is not required when you use the terminal. qm disk import can import the qcow2 file directly.

fhemberger · 2024-10-25T08:37:18Z

content/docs/latest/installing/vms/proxmoxve.md

+qm disk import $VM_ID flatcar_production_proxmoxve_image.bin local
+
+# tell the vm to boot from the imported image
+qm set $VM_ID --scsi0 local:$VM_ID/vm-$VM_ID-disk-0.raw


Proxmox 8.2 uses a different notation:
qm set $VM_ID --scsi0 local-lvm:vm-$VM_ID-disk-0

fhemberger · 2024-10-25T10:01:18Z

content/docs/latest/installing/vms/proxmoxve.md

+export VM_ID=123
+
+# create the vm and import the image to it's disk
+qm create $VM_ID


Should include a network interface and probably some CPU/RAM settings:

qm create $VM_ID --cores 2 --memory 4096 --net0 "virtio,bridge=vmbr0" --ipconfig0 "ip=dhcp"

ader1990 · 2024-10-25T13:00:50Z

content/docs/latest/installing/vms/proxmoxve.md

+
+# create the vm and import the image to it's disk
+qm create $VM_ID
+qm disk import $VM_ID flatcar_production_proxmoxve_image.bin local


local-lvm supports disks, local seems to support only ISOs

ader1990 · 2024-10-25T13:07:30Z

content/docs/latest/installing/vms/proxmoxve.md

+
+## Configuring the VM with Openstack-style cloud-init config
+
+Our VM can be booted as-is, however we might want to add a cloud-init configuration.


The VM I booted without config drive is not booting - as it stops at the initrd stage and drops into an emergency shell, because the coreos-metadata service fails.

Fixed by:

# Create the cloud-init CD-ROM drive which activates the cloud-init options for the VM. qm set $VM_ID --ide2 local-lvm:cloudinit

ader1990 · 2024-10-25T13:09:54Z

content/docs/latest/installing/vms/proxmoxve.md

+- Setting hostname (hostname is always $VM_ID)
+- Writing SSH keys
+- Writing network configuration
+


A small note should be added: if username and password is set, it will not work.

Rather a big note. I've been messing around with the settings a bit:

Setting username, password and SSH key via Proxmox-GUI, providing ignition.json only with "ignition" stanza: Doesn't work, Flatcar doesn't initialize.

Setting username, password and SSH key via Proxmox-GUI, setting same username (w/o pw/key) in ignition: User settings are not merged, no login posssible.

Setting only SSH key (leaving username/password), user core w/o SSH key in ignition.json: User settings are not merged, no login posssible.

Hostname is not VM name/ID, console still shows localhost, when no /etc/hostname is provided in ignition.json.

Not saying it should be supposed at this point, but this will defninitively be an issue people will run into. Best would be to point out to use ignition config only and not cloud init settings in the GUI.

ader1990 · 2024-10-25T13:14:32Z

content/docs/latest/installing/vms/proxmoxve.md

+        ]
+      }
+    ]
+  }


it s also worth to add a kernelArguments with autologin here, just to have a more friendly environment for testing this out.

also, the cloud-init config drive needs to be added in order for the snippet to work.

This worked for me with ignition:

export VM_ID=124 # create the vm and import the image to it's disk qm create $VM_ID --cores 2 --memory 4096 --net0 "virtio,bridge=vmbr0" --ipconfig0 "ip=dhcp" qm disk import $VM_ID flatcar_production_proxmoxve_image.bin local-lvm # tell the vm to boot from the imported image qm set $VM_ID --scsi0 local-lvm:vm-$VM_ID-disk-0 qm set $VM_ID --boot order=scsi0 qm set $VM_ID --ide2 local-lvm:cloudinit qm set $VM_ID --cicustom "user=local:snippets/user-data" qm start $VM_ID

tormath1 · 2024-11-13T15:48:14Z

Hello @arcln the image is now available - are you still interested in continuing this PR? That'd be awesome for users to know how to deploy Flatcar on Proxmox.

tormath1 · 2024-11-14T13:29:01Z

content/docs/latest/installing/vms/proxmoxve.md

+```bash
+# THIS IS A DEVELOPMENT BUILD
+# TODO: update link with an alpha build
+wget http://bincache.flatcar-linux.net/images/amd64/9999.0.102+kai-proxmox-support/flatcar_production_proxmoxve_image.img.bz2 | bzip2 -d > flatcar_production_proxmoxve_image.img


Suggested change

wget http://bincache.flatcar-linux.net/images/amd64/9999.0.102+kai-proxmox-support/flatcar_production_proxmoxve_image.img.bz2 | bzip2 -d > flatcar_production_proxmoxve_image.img

wget https://alpha.release.flatcar-linux.net/amd64-usr/current/flatcar_production_proxmoxve_image.img

tormath1 · 2025-01-10T09:45:55Z

Hello @arcln the image is now available - are you still interested in continuing this PR? That'd be awesome for users to know how to deploy Flatcar on Proxmox.

Hello @arcln and best wishes for the new year. I am circling back to this PR, if you don't have spare cycles to work on this do you agree on letting the community or the maintainers taking over this PR and of course mentioning you as the initial author of the commit? Let us know :)

tormath1 · 2025-06-27T09:39:39Z

This PR can be closed in favor of: #445 - thanks @arcln for the initial push and @fhemberger for taking over 🚀

docs: proxmoxve: add promoxve install doc

853e5b7

bitdriftr marked this pull request as draft June 4, 2024 15:37

abuisine mentioned this pull request Jun 5, 2024

OEM: Provide Proxmox images flatcar/scripts#1783

Merged

2 tasks

tormath1 reviewed Jun 6, 2024

View reviewed changes

github-actions bot mentioned this pull request Jun 22, 2024

Monthly contributions report 2024-05-22 - 2024-06-21 flatcar/Flatcar#1477

Closed

fhemberger reviewed Oct 25, 2024

View reviewed changes

ader1990 reviewed Oct 25, 2024

View reviewed changes

tormath1 mentioned this pull request Nov 13, 2024

Proxmox support flatcar/Flatcar#1040

Closed

tormath1 reviewed Nov 14, 2024

View reviewed changes

fhemberger mentioned this pull request Jun 27, 2025

docs: proxmoxve: add promoxve install doc #445

Merged

tormath1 closed this Jun 27, 2025

github-actions bot mentioned this pull request Jul 22, 2025

Monthly contributions report 2025-06-22 - 2025-07-21 flatcar/Flatcar#1822

Closed

	wget http://bincache.flatcar-linux.net/images/amd64/9999.0.102+kai-proxmox-support/flatcar_production_proxmoxve_image.img.bz2 \| bzip2 -d > flatcar_production_proxmoxve_image.img
	wget http://bincache.flatcar-linux.net/images/amd64/9999.0.102+kai-proxmox-support/flatcar_production_proxmoxve_image.img


		## Configuring the VM with Openstack-style cloud-init config

		Our VM can be booted as-is, however we might want to add a cloud-init configuration.

	wget http://bincache.flatcar-linux.net/images/amd64/9999.0.102+kai-proxmox-support/flatcar_production_proxmoxve_image.img.bz2 \| bzip2 -d > flatcar_production_proxmoxve_image.img
	wget https://alpha.release.flatcar-linux.net/amd64-usr/current/flatcar_production_proxmoxve_image.img

Conversation

bitdriftr commented Jun 4, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

fhemberger left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

fhemberger Oct 25, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tormath1 commented Nov 13, 2024

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tormath1 commented Jan 10, 2025

Uh oh!

tormath1 commented Jun 27, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

bitdriftr commented Jun 4, 2024 •

edited

Loading

fhemberger left a comment •

edited

Loading

fhemberger Oct 25, 2024 •

edited

Loading