apache · harikrishna-patnala · Nov 7, 2025 · Nov 9, 2025 · Nov 10, 2025 · Nov 10, 2025
diff --git a/source/_global.rst b/source/_global.rst
@@ -25,20 +25,20 @@
 
 .. Latest version systemvm template name
 
-.. |sysvm64-version|     replace:: 4.20.2
-.. |sysvm64-name-xen|    replace:: systemvm-xenserver-4.20.2-x86_64
-.. |sysvm64-name-kvm|    replace:: systemvm-kvm-4.20.2-x86_64
-.. |sysvm64-name-vmware| replace:: systemvm-vmware-4.20.2-x86_64
-.. |sysvm64-name-hyperv| replace:: systemvm-hyperv-4.20.2-x86_64
-.. |sysvm64-name-ovm|    replace:: systemvm-ovm-4.20.2-x86_64
+.. |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
 
 .. Latest version systemvm template URL
-.. |sysvm64-url-xen|            replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.2-x86_64-xen.vhd.bz2
-.. |sysvm64-url-kvm|            replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.2-x86_64-kvm.qcow2.bz2
-.. |sysvm64-url-kvm-aarch64|    replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.2-aarch64-kvm.qcow2.bz2
-.. |sysvm64-url-vmware|         replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.2-x86_64-vmware.ova
-.. |sysvm64-url-hyperv|         replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.2-x86_64-hyperv.vhd.zip
-.. |sysvm64-url-ovm|            replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.2-x86_64-ovm.raw.bz2
+.. |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-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
 
 .. Images
 

diff --git a/source/conf.py b/source/conf.py
@@ -24,9 +24,9 @@
 author = 'Apache CloudStack Project'
 
 # The short X.Y version
-version = '4.21'
+version = '4.22'
 # The full version, including alpha/beta/rc tags
-release = '4.21.0.0'
+release = '4.22.0.0'
 
 rst_epilog = """
 .. include:: /_global.rst 

diff --git a/source/installguide/management-server/_pkg_install.rst b/source/installguide/management-server/_pkg_install.rst
@@ -46,8 +46,8 @@ Install on SUSE
 
    zypper install cloudstack-management
 
-Install on Ubuntu
-^^^^^^^^^^^^^^^^^
+Install on Ubuntu/Debian
+^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. parsed-literal::
 

diff --git a/source/installguide/management-server/_pkg_repo.rst b/source/installguide/management-server/_pkg_repo.rst
@@ -88,6 +88,8 @@ Now you should now be able to install CloudStack using zypper.
 DEB package repository
 ~~~~~~~~~~~~~~~~~~~~~~
 
+In Ubuntu:
+
 You can add a DEB package repository to your apt sources with the
 following commands. Replace the code name with your Ubuntu LTS version :
 Ubuntu 18.04 (Bionic), Ubuntu 20.04 (Focal), Ubuntu 22.04 (Jammy), and Ubuntu 24.04 (Noble).
@@ -115,4 +117,31 @@ Now update your local apt cache.
 
 Your DEB package repository should now be configured and ready for use.
 
+In Debian:
+
+You can also install CloudStack on Debian systems using APT in the same way
+as on Ubuntu. Replace the Debian release codename (for example, "bookworm"
+for Debian 12 or "bullseye" for Debian 11) as appropriate.
+
+Use your preferred editor and open (or create)
+``/etc/apt/sources.list.d/cloudstack.list``. Add the community provided
+repository to the file (replace "noble" with "bookworm" or "bullseye" if it is the case):
+
+.. parsed-literal::
+
+   deb https://download.cloudstack.org/debian bookworm |version|
+
+We now have to add the public key to the trusted keys.
+
+.. parsed-literal::
+
+   wget -O - https://download.cloudstack.org/release.asc |sudo tee /etc/apt/trusted.gpg.d/cloudstack.asc
+
+Now update your local apt cache.
+
+.. parsed-literal::
+
+   sudo apt update
+
+Your DEB package repository should now be configured and ready for use.
 
diff --git a/source/releasenotes/about.rst b/source/releasenotes/about.rst
@@ -17,34 +17,38 @@
 What's New in |release|
 =======================
 
-Apache CloudStack |release| is a 4.21 Regular release with 15 new features,
-around 40 improvements and more than 150 bug fixes since the 4.20.1.0 release.
+Apache CloudStack |release| is a 4.22 LTS release with 10 new features,
+around 15 improvements and more than 140 bug fixes since the 4.21.0.0 release.
 Some of the highlights include:
 
-• CloudStack Extensions Framework and Orchestrate Anything extension, with built-in extensions for Proxmox and Hyper-V
-• GPU Integration with KVM in CloudStack (Technical Preview)
-• Netris Network Plugin Integration
-• Cloudian HyperStore Object Store Plugin Integration
-• CloudStack Kubernetes Service (CKS) Enhancements
-• Create Instance from Backup
-• Instance Lease (Automatic Stop/Deletion)
-• Backup and Object Storage Limits
-• Virtual Trusted Platform Module (vTPM) Support
-• Support for KVM on s390x (IBM Z and LinuxONE) architecture
-• Management Server Maintenance Mode
-• Incremental Volume Snapshots for KVM
-• File-Based Disk-Only Instance Snapshots with KVM
-• Reconciliation of VM and Volume Copy/Migrate operations for KVM agent
-• Storage Access Groups
-• Volume Allocation Algorithm Support
-• VMware to KVM migration improvements
-• Storage plugins - Ceph, PowerFlex, StorPool, Linstor related fixes and improvements
-• Several UI fixes and improvements, including Deploy Instance Form, Announcement Banner, etc
+Enhanced Backup and Disaster Recovery
+SSL Offloading for Load Balancers
+Baremetal/MaaS Extension
+CSI Driver for CKS
+Console Access for Proxmox in Extensions Framework
+VMware-to-KVM Migration Enhancements
+Snapshot/Backup Schedule Listing
+Per-Zone Console Proxy Configuration
+Direct Volume Migration within Cluster
+Persistent KVM Domains
+Support for userdata on System VMs
+EL10 & OpenSUSE 15.6 Platform Support
+Stronger Checksum Algorithm (SHA-512)
+Enable KVM volume and VM snapshot by default
+Support xz format for template registration
+Support for shared Filesystem on Config Drive Networks
 
 Known Issues
 ------------
 
-• Usage data for Instance Backups does not update after the final backup of an Instance is deleted
+• Starting 4.21 VM snapshots are supported for instances on KVM hosts. However, volume snapshots and VM snapshots cannot coexist.
+  Restoring a volume snapshot will remove any existing VM snapshots and may lead to data loss.
+  There is a UI issue where error messages in such scenarios may not clearly indicate the problem.
+
+• When managing and unmanaging UEFI-based VMs on KVM hosts, migration of such VMs may fail in certain scenarios.
+  This typically occurs when a VM that was unmanaged and later re-imported is started on a different host and then
+  migrated back to its original host. The migration fails because the VM domain still exists on the original host,
+  resulting in a conflict. As a workaround, manually remove the old domain from the original host before attempting the migration again.
 
 The full list of new features can be found in the project release notes at
-https://docs.cloudstack.apache.org/en/4.21.0.0/releasenotes/changes.html
+https://docs.cloudstack.apache.org/en/4.22.0.0/releasenotes/changes.html