API doc for automatic container rootfs initialization


New Member
May 1, 2019
Hello! I'm using the REST API to create LXC containers, and one problem I had is that I could not find any documentation on how the rootfs parameter should be passed to have PVE to automatically create and format the root volume, and copy the template there.

After some googling, I found on these forums the answer, it was passing the volume string as storage:size (size in GB). However, I could not find it in https://pve.proxmox.com/pve-docs/api-viewer , nor in PVESH.

My question is: where is the official documentation for this parameter formatting?
  • Like
Reactions: knotty66

The special syntax of <storageid>:<size> is not too well documented, I agree, however you can find the description in the manpage of pct (`man pct` - search for 'Mount Points') - `pct` is the CLI tool for managing containers, and uses the API-definitions itself.

Hope this helps!
Thanks Stoiko! The pct manual has the information and is very complete. Hope you can update also the API doc sometime, I have to say that the API doc is also in very good shape. If pct and qm follow the API definitions then I will have in mind to complement the API doc with their manpages when needed.



The Proxmox community has been around for many years and offers help and support for Proxmox VE, Proxmox Backup Server, and Proxmox Mail Gateway.
We think our community is one of the best thanks to people like you!

Get your subscription!

The Proxmox team works very hard to make sure you are running the best software and getting stable updates and security enhancements, as well as quick enterprise support. Tens of thousands of happy customers have a Proxmox subscription. Get yours easily in our online shop.

Buy now!