This SUSE product includes materials licensed to SUSE under the GNU General Public License (GPL). The GPL requires that SUSE makes available certain source code that corresponds to the GPL-licensed material. The source code is available for download.

For up to three years after SUSE’s distribution of the SUSE product, SUSE will mail a copy of the source code upon request. Requests should be sent by e-mail or as otherwise instructed here. SUSE may charge a fee to recover reasonable costs of distribution.

Version revision history

  • September 2021: 4.2.2 release

  • August 12th, 2021: 4.2.1 release

  • June 21st, 2021: 4.2 GA

About SUSE Manager Proxy 4.2

SUSE Manager Proxy provides mirroring proxy support for large and distributed environments.

Operation of the proxy is completely transparent. The SUSE Manager Proxy looks like a managed client to SUSE Manager Server, and like a server to the managed clients. Managed clients talk to the Proxy only, and the Proxy in turn communicates to the SUSE Manager Server.

All software packages that pass the SUSE Manager Proxy are cached and subsequent client requests for these packages are resolved from the cache.

System requirements

SUSE Manager Proxy is available for x86_64 architecture only. We recommend you have at least 8 GB main memory, and approximately 50 GB of disk space per distribution or channel.

Consider additional disk space required for storing images for retail terminals.

For more details on system requirements, see the Installation Guide on

SUSE Manager Proxy distribution

SUSE Manager Proxy 4.2 is provided through SUSE Customer Center and can be installed with the unified installer for SUSE Linux Enterprise 15 SP3.

Installation and setup

Installation of SUSE Manager Proxy 4.2 is done with the SUSE Manager Server 4.2 Web interface.

For more details on installing and configuring SUSE Manager Proxy 4.2, see the Installation Guide on

Upgrade from previous version

To upgrade an existing SUSE Manager Proxy 4.1 or 4.0 system to SUSE Manager Proxy 4.2, you can do an in-place upgrade, or you can set up a new system to replace the old one.

For more information about upgrading, see the Upgrade Guide on

SUSE Manager Server versions

SUSE Manager Proxy 4.2 works only with SUSE Manager 4.2 Server.

SUSE Manager Server 4.2 works with SUSE Manager Proxy 4.0 and SUSE Manager Proxy 4.1 but only for migration purposes. The product is not intended to be used in a mixed-version scenario in production.

Major changes since SUSE Manager Proxy 4.2 GA

Features and changes

Version 4.2.2

Prometheus available for SUSE Manager Proxy and Retail Branch Server

From this version, the Prometheus package will also be available for SUSE Manager Proxy and Retail Branch Server. In case you plan to use the branch server or proxy as a monitoring server with Prometheus, be aware that Prometheus demands additional hardware resources.


The Ansible package will also be available for SUSE Manager Proxy and Retail Branch Server, which makes it possible to use SUSE Manager Proxy and Retail Branch Server as Ansible control Node

Please keep in mind that besides additional resources, one needs to take care when making SUSE Manager Proxy or Retail Branch Server an Ansible control Node, considering that extra load can affect these critical component’s performance which can further affect attached clients.

Version 4.2.1

Bugfix release.


The SUSE Patch Finder is a simple online service to view released patches.

Version 4.2.2


  • Update translation strings


  • Update translation strings

  • Make schedule_deletearchived to get all actions without display limit

  • Allow passing a date limit for schedule_deletearchived on spacecmd (bsc#1181223)

  • Use correct API endpoint in list_proxies (bsc#1188042)

  • Add schedule_deletearchived to bulk delete archived actions (bsc#1181223)


  • Update translation strings

  • Fix typo "verfication" instead of "verification"


  • Prepare the bootstrap script generator for Rocky Linux 8


  • Update translation strings


  • Add new refresh_pattern to the squid.conf to fix a case where the repodata was invalid due to being cached (bsc#1186026)


  • Don’t capitalize acronyms

  • Update translation strings

  • 'AppStreams with defaults' filter template in CLM

  • Add a link to OS image store dir in image list page

  • Link to CLM filter creation from system details page

  • Expose UEFI parameters in the VM creation/editing pages

  • Add virt-tuner templates to VM creation

  • Fix cleanup always being executed on delete system (bsc#1189011)

  • Add support for Kiwi options

  • Fix virtualization guests to handle null HostInfo

  • Compare lowercase CPU arch with libvirt domain capabilities

  • Refresh JWT virtual console token before it expires

  • Handle virtual machines running on pacemaker cluster


  • Add Debian 11

  • Add Rocky Linux 8


  • Adapt to work on machines with multiple IP’s (bsc#1189263)

Version 4.2.1


  • Make spacecmd aware of retracted patches/packages


  • Fix rpm handling of empty package group and devicefiles tag (bsc#1186650)

  • Check if batch needs to be imported even after failure (bsc#1183151)

  • Show better error message when reposync failed


  • Generate SSL private keys FIPS 140-2 compatible (bsc#1187593)


  • Add option to run Ansible playbooks in 'test' mode

  • New filter template: Live patching based on a system

  • Fix bugged search in formula catalog

  • Convert Virtualization modal dialogs to react-modal

  • Update the version for the WebUI


  • Handle broken RPM packages to prevent exceptions causing fails on repository synchronization (bsc#1186650)

Major Changes Since SUSE Manager Proxy 4.1

Salt 3002

Salt has been upgraded to upstream version 3002, plus a number of patches, backports and enhancements by SUSE, for the SUSE Manager Server, Proxy and Client Tools (where the client operating system supports Python 3.5+; otherwise Salt 3000 or 2016.11 are used).

We intend to regularly upgrade Salt to more recent versions.

For more details about changes in your manually-created Salt states, see the Salt 3002 upstream release notes.

SLES 15 SP3 JeOS as a Base System

The SUSE Manager 4.1 Proxy and Retail Branch Server can now be installed on top of SLES 15 SP3 JeOS edition.

Base System Upgrade

The base system was upgraded to SUSE Linux Enterprise 15 SP3.

Known issues

Proxy password

Do not use the '@' character in the SUSE Manager Proxy password, as it is not escaped correctly.

Single Sign On, API and CLI tools

Single Sign On can be used to authenticate in the Web UI but not with the API or CLI tools. This will be fixed in a future release of SUSE Manager.


Future deprecation of the traditional stack

This version of SUSE Manager is compatible with Salt and traditional clients. SUSE will deprecate traditional clients and traditional proxies in the next SUSE Manager 4.3 release. The release that follows SUSE Manager 4.3 will not support traditional clients and traditional proxies, and is planned for 2023. We encourage all new deployments to use Salt clients and Salt proxies exclusively, and to migrate existing traditional clients and proxies to Salt.

Providing feedback

If you encounter a bug in any SUSE product, please report it through your SUSE Customer Service or Sales representatives.

You can also provide feedback using SUSE forums, or the upstream Uyuni Project community.


Latest product documentation:

Technical product information for SUSE Manager:

These release notes are available online:

Visit for the latest Linux product news from SUSE.

Visit for additional information on the source code of SUSE Linux Enterprise products.

Maxfeldstr. 5
D-90409 Nürnberg
Tel: +49 (0)911 740 53 - 0
Registrierung/Registration Number: HRB 36809 AG Nürnberg
Geschäftsführer/Managing Director: Felix Imendörffer
Steuernummer/Sales Tax ID: DE 192 167 791
Erfüllungsort/Legal Venue: Nürnberg

SUSE makes no representations or warranties with regard to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, SUSE reserves the right to revise this publication and to make changes to its content, at any time, without the obligation to notify any person or entity of such revisions or changes.

Further, SUSE makes no representations or warranties with regard to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, SUSE reserves the right to make changes to any and all parts of SUSE software, at any time, without any obligation to notify any person or entity of such changes.

Any products or technical information provided under this Agreement may be subject to U.S. export controls and the trade laws of other countries. You agree to comply with all export control regulations and to obtain any required licenses or classifications to export, re-export, or import deliverables. You agree not to export or re-export to entities on the current U.S. export exclusion lists or to any embargoed or terrorist countries as specified in U.S. export laws. You agree to not use deliverables for prohibited nuclear, missile, or chemical/biological weaponry end uses. Please refer to the SUSE Legal information page for more information on exporting SUSE software. SUSE assumes no responsibility for your failure to obtain any necessary export approvals.

Copyright © 2012-2021 SUSE LLC.

This release notes document is licensed under a Creative Commons Attribution-NoDerivatives 4.0 International License (CC-BY-ND-4.0). You should have received a copy of the license along with this document. If not, see

SUSE has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at and one or more additional patents or pending patent applications in the U.S. and other countries.

For SUSE trademarks, see SUSE Trademark and Service Mark list ( All third-party trademarks are the property of their respective owners.


Thank you for using SUSE Manager Proxy and/or SUSE Manager Retail Branch Server in your business.

Your SUSE Manager Team.