From 1cd2045a02f0462f70388ddecb3cb2f9dba81d4b Mon Sep 17 00:00:00 2001 From: Wei Zhou Date: Tue, 10 Nov 2026 14:14:40 +0100 Subject: [PATCH 1/8] Update docs for Debian 13 system VM template and built-in templates The system VM template is now based on Debian 13 (trixie) instead of Debian 12. The built-in CentOS 5.5 template used in the quick install guide and the installation guide is replaced by the Debian 13 (64-bit) genericcloud template for KVM. --- source/adminguide/systemvm.rst | 2 +- source/installguide/configuration.rst | 4 ++-- source/quickinstallationguide/qig.rst | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/source/adminguide/systemvm.rst b/source/adminguide/systemvm.rst index ec0e00d298..e3f9082c06 100644 --- a/source/adminguide/systemvm.rst +++ b/source/adminguide/systemvm.rst @@ -27,7 +27,7 @@ The System VM Template The System VMs come from a single Template. The System VM has the following characteristics: -- Debian 12(bookwork), 6.1.0 kernel with the latest security +- Debian 13 (trixie) with its default kernel and the latest security patches from the Debian security APT repository - Has a minimal set of packages installed thereby reducing the attack diff --git a/source/installguide/configuration.rst b/source/installguide/configuration.rst index c6c3ee512b..5fcc63aba9 100644 --- a/source/installguide/configuration.rst +++ b/source/installguide/configuration.rst @@ -1871,7 +1871,7 @@ of your network. When the initialization has completed successfully, the administrator's Dashboard should be displayed in the CloudStack UI. #. Verify that the system is ready. In the left navigation bar, select - Templates. Click on the CentOS 5.5 (64bit) no Gui (KVM) Template. + Templates. Click on the Debian 13 (64-bit) genericcloud (KVM) Template. Check to be sure that the status is "Download Complete." Do not proceed to the next step until this status is displayed. @@ -1882,7 +1882,7 @@ administrator's Dashboard should be displayed in the CloudStack UI. #. Choose the zone you just added. #. In the Template selection, choose the Template to use in the instance. - If this is a fresh installation, likely only the provided CentOS + If this is a fresh installation, likely only the provided Debian 13 Template is available. #. Select a service offering. Be sure that the hardware you have diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst index 920641560f..a8dc5cdca0 100644 --- a/source/quickinstallationguide/qig.rst +++ b/source/quickinstallationguide/qig.rst @@ -756,7 +756,7 @@ That's it, you are done with installation of your Apache CloudStack demo cloud. To check the health of your CloudStack installation, go to Infrastructure --> System VMs and refresh the UI from time to time - you should see “S-1-VM” and “V-2-VM” system VMs (SSVM and CPVM) in State=Running and Agent State=Up -After that you can go to Images --> Templates, click on the built-in Template named "CentOS 5.5(64-bit) no GUI (KVM)", +After that you can go to Images --> Templates, click on the built-in Template named "Debian 13 (64-bit) genericcloud (KVM)", then click on "Zones" tab - and observe how the Status is moving from a few percents downloaded up to fully downloaded, after which the Status will show as "Download Complete" and "Ready" column will say "Yes". After this is done, you will be able to deploy an Instance from this Template. From 87120097cc1670bbf1697a0a5959c9a5e8d84a3a Mon Sep 17 00:00:00 2001 From: Wei Zhou Date: Tue, 10 Nov 2026 15:07:30 +0100 Subject: [PATCH 2/8] Point System VM template variables to the 24.0 release The System VM templates for 24.0 are published under systemvm/24/. The aarch64 KVM template is not published there yet, so its URL still points to the 4.22.0 template. --- source/_global.rst | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/source/_global.rst b/source/_global.rst index 4b2c84d235..2f2c54e8c7 100644 --- a/source/_global.rst +++ b/source/_global.rst @@ -25,20 +25,20 @@ .. Latest version systemvm template name -.. |sysvm64-version| replace:: 4.22.0 -.. |sysvm64-name-xen| replace:: systemvm-xenserver-4.22.0-x86_64 -.. |sysvm64-name-kvm| replace:: systemvm-kvm-4.22.0-x86_64 -.. |sysvm64-name-vmware| replace:: systemvm-vmware-4.22.0-x86_64 -.. |sysvm64-name-hyperv| replace:: systemvm-hyperv-4.22.0-x86_64 -.. |sysvm64-name-ovm| replace:: systemvm-ovm-4.22.0-x86_64 +.. |sysvm64-version| replace:: 24.0 +.. |sysvm64-name-xen| replace:: systemvm-xenserver-24.0-x86_64 +.. |sysvm64-name-kvm| replace:: systemvm-kvm-24.0-x86_64 +.. |sysvm64-name-vmware| replace:: systemvm-vmware-24.0-x86_64 +.. |sysvm64-name-hyperv| replace:: systemvm-hyperv-24.0-x86_64 +.. |sysvm64-name-ovm| replace:: systemvm-ovm-24.0-x86_64 .. Latest version systemvm template URL -.. |sysvm64-url-xen| replace:: http://download.cloudstack.org/systemvm/4.22/systemvmtemplate-4.22.0-x86_64-xen.vhd.bz2 -.. |sysvm64-url-kvm| replace:: http://download.cloudstack.org/systemvm/4.22/systemvmtemplate-4.22.0-x86_64-kvm.qcow2.bz2 +.. |sysvm64-url-xen| replace:: http://download.cloudstack.org/systemvm/24/systemvmtemplate-24.0-x86_64-xen.vhd.bz2 +.. |sysvm64-url-kvm| replace:: http://download.cloudstack.org/systemvm/24/systemvmtemplate-24.0-x86_64-kvm.qcow2.bz2 .. |sysvm64-url-kvm-aarch64| replace:: http://download.cloudstack.org/systemvm/4.22/systemvmtemplate-4.22.0-aarch64-kvm.qcow2.bz2 -.. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/4.22/systemvmtemplate-4.22.0-x86_64-vmware.ova -.. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/4.22/systemvmtemplate-4.22.0-x86_64-hyperv.vhd.zip -.. |sysvm64-url-ovm| replace:: http://download.cloudstack.org/systemvm/4.22/systemvmtemplate-4.22.0-x86_64-ovm.raw.bz2 +.. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/24/systemvmtemplate-24.0-x86_64-vmware.ova +.. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/24/systemvmtemplate-24.0-x86_64-hyperv.vhd.zip +.. |sysvm64-url-ovm| replace:: http://download.cloudstack.org/systemvm/24/systemvmtemplate-24.0-x86_64-ovm.raw.bz2 .. Images From d56a566ab1fd4a4dfb0114921de61a066c04217f Mon Sep 17 00:00:00 2001 From: Wei Zhou Date: Tue, 10 Nov 2026 15:18:11 +0100 Subject: [PATCH 3/8] Document the Debian 13 built-in templates in the quick install guide Describe the built-in Debian 13 templates for KVM, XenServer and VMware: the template names, the guest agent of each hypervisor, cloud-init datasources, the default user, the root login and password reset. --- source/quickinstallationguide/qig.rst | 29 +++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst index a8dc5cdca0..fccc3faddd 100644 --- a/source/quickinstallationguide/qig.rst +++ b/source/quickinstallationguide/qig.rst @@ -761,3 +761,32 @@ then click on "Zones" tab - and observe how the Status is moving from a few perc after which the Status will show as "Download Complete" and "Ready" column will say "Yes". After this is done, you will be able to deploy an Instance from this Template. +Debian 13 Built-in Template +~~~~~~~~~~~~~~~~~~~~~~~~~~~ +The built-in templates are Debian 13 (trixie) cloud images, patched for CloudStack, which +replace the CentOS 5.x templates of earlier releases. Each hypervisor has its own template: + +#. KVM: "Debian 13 (64-bit) genericcloud (KVM)" +#. XenServer: "Debian 13 (64-bit) genericcloud (XenServer)" +#. VMware: "Debian 13 (64-bit) genericcloud (vSphere)" + +The template for your hypervisor is downloaded to secondary storage the first time it is +used, so the first Instance deployment can take several minutes. Wait until the template +shows "Download Complete" and "Ready" before deploying an Instance from it. + +The templates include the guest agent for each hypervisor: + +#. KVM: QEMU guest agent (``qemu-guest-agent``) +#. VMware: open-vm-tools (``open-vm-tools``) +#. XenServer: XenServer guest utilities (``xe-guest-utilities``) + +cloud-init supports the ConfigDrive and CloudStack datasources. + +The default user is ``debian``. Password and SSH key access are supported. Both can be reset from CloudStack. + +SSH login as root is disabled. The root password is ``password``, and you can use it to log in from the VM console. + +.. warning:: + The root password of the built-in template is publicly known. Change it, or use an SSH + key, before you expose an Instance deployed from this template to a network. + From 5a4aac6681e4fbed0d236af5c46d8056807377d9 Mon Sep 17 00:00:00 2001 From: Wei Zhou Date: Tue, 10 Nov 2026 17:08:49 +0100 Subject: [PATCH 4/8] Update source/_global.rst --- source/_global.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_global.rst b/source/_global.rst index 2f2c54e8c7..105d2dcbd2 100644 --- a/source/_global.rst +++ b/source/_global.rst @@ -35,7 +35,7 @@ .. Latest version systemvm template URL .. |sysvm64-url-xen| replace:: http://download.cloudstack.org/systemvm/24/systemvmtemplate-24.0-x86_64-xen.vhd.bz2 .. |sysvm64-url-kvm| replace:: http://download.cloudstack.org/systemvm/24/systemvmtemplate-24.0-x86_64-kvm.qcow2.bz2 -.. |sysvm64-url-kvm-aarch64| replace:: http://download.cloudstack.org/systemvm/4.22/systemvmtemplate-4.22.0-aarch64-kvm.qcow2.bz2 +.. |sysvm64-url-kvm-aarch64| replace:: http://download.cloudstack.org/systemvm/24/systemvmtemplate-24.0-aarch64-kvm.qcow2.bz2 .. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/24/systemvmtemplate-24.0-x86_64-vmware.ova .. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/24/systemvmtemplate-24.0-x86_64-hyperv.vhd.zip .. |sysvm64-url-ovm| replace:: http://download.cloudstack.org/systemvm/24/systemvmtemplate-24.0-x86_64-ovm.raw.bz2 From 821ce5ebfe55651e644937ae1ace9b533535144b Mon Sep 17 00:00:00 2001 From: Wei Zhou Date: Thu, 12 Nov 2026 07:12:39 +0100 Subject: [PATCH 5/8] Note that upgrades need the Debian 13 template registered manually Upgrades from earlier releases do not get the built-in Debian 13 templates, so the template must be registered by the administrator. --- source/quickinstallationguide/qig.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst index fccc3faddd..baa4bba93a 100644 --- a/source/quickinstallationguide/qig.rst +++ b/source/quickinstallationguide/qig.rst @@ -774,6 +774,10 @@ The template for your hypervisor is downloaded to secondary storage the first ti used, so the first Instance deployment can take several minutes. Wait until the template shows "Download Complete" and "Ready" before deploying an Instance from it. +.. note:: + Upgrades from earlier releases do not get the built-in Debian 13 templates. Register the + Debian 13 template for your hypervisor manually, as described in the upgrade instructions. + The templates include the guest agent for each hypervisor: #. KVM: QEMU guest agent (``qemu-guest-agent``) From 16d0090f2d18765bb21c335272c6439f2eb5c2be Mon Sep 17 00:00:00 2001 From: Wei Zhou Date: Thu, 12 Nov 2026 08:15:54 +0100 Subject: [PATCH 6/8] Link the built-in template upgrade note and document VMware template settings Point the note on upgrades to the template registration section, and describe the vmxnet3 NIC and pvscsi root disk controller set on the VMware built-in template. --- source/quickinstallationguide/qig.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst index baa4bba93a..7d294c4dca 100644 --- a/source/quickinstallationguide/qig.rst +++ b/source/quickinstallationguide/qig.rst @@ -776,7 +776,8 @@ shows "Download Complete" and "Ready" before deploying an Instance from it. .. note:: Upgrades from earlier releases do not get the built-in Debian 13 templates. Register the - Debian 13 template for your hypervisor manually, as described in the upgrade instructions. + Debian 13 template for your hypervisor manually, as described in + `Uploading Templates from a remote HTTP server <../adminguide/templates.html#uploading-templates-from-a-remote-http-server>`_. The templates include the guest agent for each hypervisor: @@ -786,6 +787,10 @@ The templates include the guest agent for each hypervisor: cloud-init supports the ConfigDrive and CloudStack datasources. +The VMware template uses the vmxnet3 NIC adapter and the pvscsi root disk controller. The guest +kernel has no driver for the default e1000 NIC. These are set as the template details +``nicAdapter`` and ``rootDiskController``. + The default user is ``debian``. Password and SSH key access are supported. Both can be reset from CloudStack. SSH login as root is disabled. The root password is ``password``, and you can use it to log in from the VM console. From 352e4cd75d02b9110b491ed956733a883cc933ac Mon Sep 17 00:00:00 2001 From: Wei Zhou Date: Thu, 12 Nov 2026 08:25:31 +0100 Subject: [PATCH 7/8] Move VMware template settings into a note in the quick install guide The vmxnet3 NIC adapter and pvscsi root disk controller of the VMware built-in template are shown as a note, not as a paragraph. --- source/quickinstallationguide/qig.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst index 7d294c4dca..dd6b8e849f 100644 --- a/source/quickinstallationguide/qig.rst +++ b/source/quickinstallationguide/qig.rst @@ -787,9 +787,10 @@ The templates include the guest agent for each hypervisor: cloud-init supports the ConfigDrive and CloudStack datasources. -The VMware template uses the vmxnet3 NIC adapter and the pvscsi root disk controller. The guest -kernel has no driver for the default e1000 NIC. These are set as the template details -``nicAdapter`` and ``rootDiskController``. +.. note:: + The VMware template uses the vmxnet3 NIC adapter and the pvscsi root disk controller. The guest + kernel has no driver for the default e1000 NIC. These are set as the template details + ``nicAdapter`` and ``rootDiskController``. The default user is ``debian``. Password and SSH key access are supported. Both can be reset from CloudStack. From 835f9eca6ef275f9ba348e0c08039eff1d4aeed5 Mon Sep 17 00:00:00 2001 From: Wei Zhou Date: Thu, 12 Nov 2026 08:28:51 +0100 Subject: [PATCH 8/8] Merge VMware template settings into the built-in template note Show the VMware vmxnet3 NIC and pvscsi root disk controller as a second paragraph of the upgrade note in the quick install guide. --- source/quickinstallationguide/qig.rst | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/source/quickinstallationguide/qig.rst b/source/quickinstallationguide/qig.rst index dd6b8e849f..c0df862f93 100644 --- a/source/quickinstallationguide/qig.rst +++ b/source/quickinstallationguide/qig.rst @@ -779,6 +779,10 @@ shows "Download Complete" and "Ready" before deploying an Instance from it. Debian 13 template for your hypervisor manually, as described in `Uploading Templates from a remote HTTP server <../adminguide/templates.html#uploading-templates-from-a-remote-http-server>`_. + The VMware template uses the vmxnet3 NIC adapter and the pvscsi root disk controller. The guest + kernel has no driver for the default e1000 NIC. These are set as the template details + ``nicAdapter`` and ``rootDiskController``. + The templates include the guest agent for each hypervisor: #. KVM: QEMU guest agent (``qemu-guest-agent``) @@ -787,11 +791,6 @@ The templates include the guest agent for each hypervisor: cloud-init supports the ConfigDrive and CloudStack datasources. -.. note:: - The VMware template uses the vmxnet3 NIC adapter and the pvscsi root disk controller. The guest - kernel has no driver for the default e1000 NIC. These are set as the template details - ``nicAdapter`` and ``rootDiskController``. - The default user is ``debian``. Password and SSH key access are supported. Both can be reset from CloudStack. SSH login as root is disabled. The root password is ``password``, and you can use it to log in from the VM console.