Skip to Content

Wiki source code of proxmox

Version 9.7 by Kevin Wiki on 2026/05/18 08:16
Hide last authors
Kevin Wiki 1.1 1 (% class="row" %)
2 (((
3 (% class="col-xs-12 col-sm-8" %)
4 (((
Kevin Wiki 2.1 5 {{children/}}
Kevin Wiki 1.1 6
7
Kevin Wiki 3.1 8 = Getting Started with Proxmox VE LXC and VM Templates =
Kevin Wiki 1.1 9
Kevin Wiki 3.1 10 Proxmox VE (PVE) allows users to create and manage both LXC containers and KVM virtual machines (VMs). This guide walks you through the process of downloading, importing, and creating templates for both.
11
12 == LXC Templates ==
13
14 LXC containers are lightweight and ideal for running Linux services with minimal overhead.
15
16 === List Available Templates ===
17
18 To view the available LXC templates:
19
Kevin Wiki 4.1 20 {{code language="bash"}}
Kevin Wiki 2.2 21 pveam list
Kevin Wiki 4.1 22 {{/code}}
23
Kevin Wiki 3.1 24 === Download Templates ===
25
26 Use the pveam download command to import templates to the local storage:
27
Kevin Wiki 4.1 28 {{code language="bash"}}
Kevin Wiki 2.3 29 pveam download local ubuntu-22.04-standard_22.04-1_amd64.tar.gz
30 pveam download local ubuntu-24.04-standard_24.04-1_amd64.tar.zst
31 pveam download local debian-12-standard_11.7-1_amd64.tar.zst
Kevin Wiki 4.1 32 {{/code}}
33
Kevin Wiki 3.1 34 Once downloaded, these templates can be used to create new LXC containers from the Proxmox web interface or via CLI.
Kevin Wiki 1.1 35
Kevin Wiki 3.1 36 == VM Template from Ubuntu Cloud Image ==
Kevin Wiki 2.3 37
Kevin Wiki 3.1 38 KVM VMs are ideal when you need full virtualization, for instance, to run Windows or more complex Linux systems.
Kevin Wiki 2.4 39
Kevin Wiki 3.1 40 === Download Ubuntu Cloud Image ===
41
Kevin Wiki 4.1 42 Download the official Ubuntu 24.04 cloud [[image:]]
Kevin Wiki 3.1 43
Kevin Wiki 4.1 44 {{code language="bash"}}
Kevin Wiki 3.1 45 wget http://cloud-images.ubuntu.com/releases/24.04/release/ubuntu-24.04-server-cloudimg-amd64.img
Kevin Wiki 4.1 46 {{/code}}
47
Kevin Wiki 3.1 48 === Create the Virtual Machine ===
49
50 Create a new VM with ID 910 (you can pick any unused ID):
51
Kevin Wiki 4.1 52 {{code language="bash"}}
Kevin Wiki 2.4 53 qm create 910 -name template-ubuntu-jammy -memory 2048 -net0 virtio,bridge=vmbr0 -cores 2 -sockets 1
Kevin Wiki 4.1 54 {{/code}}
55
Kevin Wiki 3.1 56 === Import and Attach the Disk ===
57
58 Choose the correct storage (replace nvme if you use a different storage name):
59
Kevin Wiki 4.1 60 {{code language="bash"}}
Kevin Wiki 2.4 61 qm importdisk 910 ubuntu-24.04-server-cloudimg-amd64.img nvme
62 qm set 910 -scsihw virtio-scsi-pci -virtio0 nvme:vm-910-disk-0
Kevin Wiki 4.1 63 {{/code}}
64
Kevin Wiki 3.1 65 === Configure the VM ===
66
Kevin Wiki 4.1 67 {{code language="bash"}}
Kevin Wiki 2.4 68 qm set 910 -serial0 socket
69 qm set 910 -boot c -bootdisk virtio0
70 qm set 910 -agent 1
71 qm set 910 -hotplug disk,network,usb
72 qm set 910 -vcpus 1
73 qm set 910 -vga qxl
74 qm set 910 -ide2 nvme:cloudinit
75 qm resize 910 virtio0 +8G
Kevin Wiki 4.1 76 {{/code}}
77
78
Kevin Wiki 3.1 79 If your disk is using SCSI instead of virtio, resize like this:
Kevin Wiki 4.1 80
81 {{code language="bash"}}
Kevin Wiki 2.4 82 qm resize 910 scsi0 +8G
Kevin Wiki 4.1 83 {{/code}}
84
Kevin Wiki 3.1 85 === Convert the VM into a Template ===
86
Kevin Wiki 4.1 87 {{code language="bash"}}
Kevin Wiki 2.4 88 qm template 910
Kevin Wiki 4.1 89 {{/code}}
90
Kevin Wiki 3.1 91 Now you can use this template to clone new VMs instantly.
92
Kevin Wiki 5.1 93 == Bash Script to Automate Setup ==
94
Kevin Wiki 6.1 95 Install the above using bash script below
Kevin Wiki 5.1 96
97 === setup_proxmox_templates.sh ===
98
Kevin Wiki 6.1 99 {{code language="bash"}}
Kevin Wiki 5.1 100 #!/bin/bash
101
102 # Exit on errors
103 set -e
104
105 echo "Downloading LXC templates..."
Kevin Wiki 8.1 106 pveam download nvme ubuntu-22.04-standard_22.04-1_amd64.tar.zst
107 pveam download nvme ubuntu-24.04-standard_24.04-2_amd64.tar.zst
108 pveam download nvme alpine-3.21-default_20241217_amd64.tar.xz
109 pveam download nvme debian-12-standard_12.7-1_amd64.tar.zst
Kevin Wiki 5.1 110
111 echo "Downloading Ubuntu cloud image..."
112 wget -N http://cloud-images.ubuntu.com/releases/24.04/release/ubuntu-24.04-server-cloudimg-amd64.img
113
114 echo "Creating VM Template..."
Kevin Wiki 8.1 115 qm create 910 -name template-ubuntu-jammy -memory 2048 -net0 virtio,bridge=vmbr0 -cores 2 -sockets 1 && 1
116
117 # qm importdisk 910 ubuntu-24.04-server-cloudimg-amd64.img nvme
118 # qm set 910 -scsihw virtio-scsi-pci -scsi0-virtio0 nvme:910/vm-910-disk-0
119 qm set 910 -scsihw virtio-scsi-pci -scsi0 nvme:0,import-from=/mnt/nvmestorage/template/iso/ubuntu-24.04-server-cloudimg-amd64.img
120
Kevin Wiki 5.1 121 qm set 910 -serial0 socket
122 qm set 910 -boot c -bootdisk virtio0
123 qm set 910 -agent 1
124 qm set 910 -hotplug disk,network,usb
125 qm set 910 -vcpus 1
126 qm set 910 -vga qxl
127 qm set 910 -ide2 nvme:cloudinit
Kevin Wiki 8.1 128 # qm resize 910 scsi0 +8G
129
130 read -p "Confirm converting to template by pressing Enter"
Kevin Wiki 5.1 131 qm template 910
Kevin Wiki 7.1 132
133 echo "Templates setup complete."
Kevin Wiki 6.1 134 {{/code}}
Kevin Wiki 5.1 135
Kevin Wiki 8.2 136
137 = VM runtime setup =
138
139 After creating the VM and before making it into a template there are some programs and settings we want to ensure exists always.
140
Kevin Wiki 8.6 141 qemu-guest-agent is for allowing proxmox to query information from the VM such as IP address, shutdown commands, etc
Kevin Wiki 8.2 142
Kevin Wiki 8.6 143 {{code language="bash"}}
144 sudo apt update
145 sudo apt upgrade -y
146 sudo apt install qemu-guest-agent -y
147
148 sudo systemctl enable qemu-guest-agent.service
149 sudo systemctl start qemu-guest-agent.service
150 {{/code}}
151
Kevin Wiki 9.4 152 cloud-init is a great hook for installing or configuring programs or receiving variables from cloudinit CDROM drive. Making it easier to change IP, hostname, DNS, username/password, etc between VMs.
Kevin Wiki 9.2 153
Kevin Wiki 9.4 154 {{code language="yaml"}}
155 # The top level settings are used as module
156 # and system configuration.
157 # A set of users which may be applied and/or used by various modules
158 # when a 'default' entry is found it will reference the 'default_user'
159 # from the distro configuration specified below
160 users:
161 - default
Kevin Wiki 9.2 162
Kevin Wiki 9.4 163 # If this is set, 'root' will not be able to ssh in and they
164 # will get a message to login instead as the default $user
165 disable_root: true
Kevin Wiki 9.2 166
Kevin Wiki 9.4 167 # This will cause the set+update hostname module to not operate (if true)
168 preserve_hostname: false
Kevin Wiki 9.2 169
Kevin Wiki 9.4 170 apt:
171 # This prevents cloud-init from rewriting apt's sources.list file,
172 # which has been a source of surprise.
173 preserve_sources_list: true
174
175 # The modules that run in the 'init' stage
176 cloud_init_modules:
177 - seed_random
178 - bootcmd
179 - write-files
180 - growpart
181 - resizefs
182 - disk_setup
183 - mounts
184 - set_hostname
185 - update_hostname
186 - update_etc_hosts
187 - ca-certs
188 - rsyslog
189 - users-groups
190 - ssh
191
192 # The modules that run in the 'config' stage
193 cloud_config_modules:
194 - locale
195 - set-passwords
196 - grub-dpkg
197 - apt-pipelining
198 - apt-configure
199 - ntp
200 - timezone
201 - disable-ec2-metadata
202 - runcmd
203
204 # The modules that run in the 'final' stage
205 cloud_final_modules:
206 - package-update-upgrade-install
207 - write-files-deferred
208 - scripts-vendor
209 - scripts-per-once
210 - scripts-per-boot
211 - scripts-per-instance
212 - scripts-user
213 - ssh-authkey-fingerprints
Kevin Wiki 9.7 214 # - keys-to-console
Kevin Wiki 9.4 215 - install-hotplug
Kevin Wiki 9.7 216 # - phone-home
Kevin Wiki 9.4 217 - final-message
218 - power-state-change
219
220 # System and/or distro specific settings
221 # (not accessible to handlers/transforms)
222 system_info:
223 # This will affect which distro class gets used
224 distro: debian
225 # Default user name + that default users groups (if added/used)
226 default_user:
227 name: debian
228 lock_passwd: True
229 gecos: Debian
Kevin Wiki 9.7 230 groups: [sudo]
231 # Disables password-less sudo commands for default/debian user
232 sudo: ["ALL=(ALL) ALL"]
Kevin Wiki 9.4 233 shell: /bin/bash
234 # Other config here will be given to the distro class and/or path classes
235 paths:
236 cloud_dir: /var/lib/cloud/
237 templates_dir: /etc/cloud/templates/
238 package_mirrors:
239 - arches: [default]
240 failsafe:
241 primary: https://deb.debian.org/debian
242 security: https://deb.debian.org/debian-security
243 ssh_svcname: ssh
244 {{/code}}
245
246
247
248
249
Kevin Wiki 3.1 250
Kevin Wiki 1.1 251 )))
252
253 (% class="col-xs-12 col-sm-4" %)
254 (((
255 (% class="box" %)
256 (((
257 |=Site|[[Proxmox>>https://proxmox.com]]
258 |=Dashboard|
259 |=Servers|1200 €
260 |=Image|[[Credits>>https://commons.wikimedia.org/wiki/File:FalabellaFestivo.jpg]]
261 )))
262
263 (% class="box" %)
264 (((
265 **Contents**
266
267 {{toc/}}
268 )))
269 )))
270 )))