Version Revision History

  • 2019/08/02: 4.0.2 release

  • 2018/12/19: 4.0.1 release

  • 2018/10/26: 4.0.0 release

Stay informed

You can stay up-to-date regarding information about Uyuni:


Uyuni is a community support project. The ways or contacting the community are available at the home site.

Release model

Uyuni uses a rolling release model (meaning there will be no bugfixing for given Uyuni version, but new frequent versions that will include bugfixes and features)

Check the home site get in contact with the community.

Major changes since Uyuni Proxy 4.0.0

Features and changes

Version 4.0.2

Prometheus Monitoring

We now include packages for the latest version of Prometheus.

Some exporters will be pre-installed on Uyuni Manager Proxy as part of its self-monitoring features. They will provide hardware, operating system, and HTTP Proxy metrics.

Formulas Update for Retail Branch Server

Formulas used to operate a Uyuni for Retail Branch Server were updated to support a SUSE Linux Enterprise 15 SP1 environment.

Configuration of Uyuni Retail Branch Server with Multiple Network Interfaces

During installation of Uyuni Retail Branch Server the secondary network interface, intended to be used for the terminal network, may be configured and bound to a firewall zone. This zone binding can interfere with the configuration of Retail services, and could result in you being unable to apply the highstate.

To avoid this problem, ensure that:

  • the primary network interface is either bound to 'public' zone or not bound to any zone

  • the secondary network interface either bound to 'internal' zone or is not bound to any firewall zone.

Do this by running these commands before you apply the retail formulas:

firewall-cmd --permanent --zone=public --change-interface=eth0
firewall-cmd --permanent --zone=internal --change-interface=eth1
firewall-cmd --reload

This example assumes eth0 is the primary interface and eth1 the secondary terminal interface.

Salt 2019.2.0

Salt has been upgraded to the 2019.2.0 release.

We intend to regularly upgrade Salt to more recent versions.

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

Base System Upgrade

The base system was upgraded to openSUSE Leap 15.1. As a result, all code was ported to run with Python 3.

Version 4.0.1

Bugfix update


System Requirements

  • OS: openSUSE Leap 15.1 x86_64, fully updated

  • Main Memory: At least 2GB

  • Disk space: approx 50 GB per distribution or channel

See the Advanced Topics manual for more details on the system requirements.

Installing the Proxy

Installation of Uyuni Proxy is done via the Uyuni Server web interface.

See the Advanced Topics manual for step-by-step instructions for installing and configuring Uyuni Proxy.

Upgrade from version 4.0.1

If you are using DHCP addresses and you do not use DHCP reservations, migrating from openSUSE Leap 42.3 to Leap 15.0 can change the IP address of your NICs. If using DHCP, make sure your instances have reserved IP addresses.

To upgrade an existing Uyuni Proxy 4.0.1 system to Uyuni Proxy 4.0.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.

Uyuni Server versions

Uyuni Proxy 4.0.2 can work with Uyuni Server 4.0.2

When upgrading, start with the server first and then continue with the proxies. See the advanced topics manual for detailed upgrade instructions.

Providing feedback

In case of encountering a bug please report it at

Copyright © 2012 – 2018 SUSE LLC and contributors. All rights reserved.

This work is licensed under the Creative Commons Attribution-ShareAlike 3.0 License. To view a copy of this license, visit or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

For SUSE trademarks, see All other third-party trademarks are the property of their respective owners. Trademark symbols (®, ™ etc.) denote trademarks of SUSE and its affiliates. Asterisks (*) denote third-party trademarks.

All information found in this document has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither SUSE LLC, its affiliates, the authors nor the translators shall be held liable for possible errors or the consequences thereof.