From 1cd2045a02f0462f70388ddecb3cb2f9dba81d4b Mon Sep 17 00:00:00 2001 From: Wei Zhou Date: Tue, 10 Nov 2026 14:14:40 +0100 Subject: [PATCH 1/4] 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/4] 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/4] 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/4] 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