usoleg/openwrt-on-proxmox.md

Forked from ch4r13/openwrt-on-proxmox.md

Last active November 24, 2025 09:38

Star (0) You must be signed in to star a gist
Fork (0) You must be signed in to fork a gist

Select an option

Learn more about clone URLs
Clone this repository at <script src="https://gist.github.com/usoleg/5fcd56b8bf7c804de8870a65a02f1213.js"></script>
Save usoleg/5fcd56b8bf7c804de8870a65a02f1213 to your computer and use it in GitHub Desktop.

Download ZIP

How to set up an OpenWRT VM in Proxmox

Raw

openwrt-on-proxmox.md

Go to OpenWRT release page, select the latest release stable release, then targets -> x86 -> 64. Right-click generic-ext4-combined.img.gz (not the "efi"!) and copy the link.
On the Proxmox host, download the archive and unpack it:

wget *paste link here*
gunzip openwrt-*.img.gz

Resize the image to be the size you want your VM's disk to be (example with 8 GiB):

qemu-img resize -f raw openwrt-*.img 8G

Create a new VM in Proxmox. Make sure to use:

No installation media
SeaBIOS
No drives

Do not start the VM yet.

Import the resized OpenWRT image into the new VM (replace VMID and STORAGEID with yours):

qm importdisk VMID openwrt-*.img STORAGEID

qm disk import 260 /var/lib/vz/template/iso/openwrt-24.10.4-x86-64-generic-ext4-combined.img local-lvm

Go to the VM -> Hardware, select the newly imported disk named "Unused Disk 0", press "Edit", set it to VirtIO with "Discard" and "IO Thread" enabled, then press OK.
Go to the VM -> Options -> Boot Order, make sure that virtio0 is at the top and is the only one that is ticked.
Add whatever networking or other devices you need.
You're done! Start the VM and enjoy all the routing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment