Stable version 2025.10

keyboard_arrow_left Go back

Release notes

WARNING: Remember to review the release notes! Since release 2025.10 Uyuni is released for a different host OS for both Uyuni Server and the Proxies!

Documentation

HTML
Guides
API
PDF

The latest documentation is also listed in the server's WebUI navigation after installation.

Server Setup


Hardware and Software Requirements
Requirement Description
openSUSE Tumbleweed Clean installation, up-to-date
Multi-core CPU x86_64
16GB RAM * Sufficient for testing purposes
100GB Disk Space ** Disk space depends on your channel requirements

* 32GB of RAM recommended for a production environment (16GB for a base installation)

**50GB per SUSE/openSUSE product and 360GB per Red Hat Product


Quickstart Installation Instructions

Please note Uyuni requires FQDNs for the Server, Proxy and clients, so usage of a properly-configured DNS server is mandatory for client updates to work.

If you want to install Uyuni in lab mode, for testing, you may be interested in how to easily make use of libvirt's included dnsmasq DNS and DHCP server: Libvirt DNS and DCHP without Avahi.

1. Update openSUSE Tumbleweed

# zypper dup

2. Reboot the system if needed

3. Configure a resolvable fully qualified domain name (FQDN)

4. Add the Uyuni Server repository:

# zypper ar https://download.opensuse.org/repositories/systemsmanagement:/Uyuni:/Stable/images/repo/Uyuni-Server-POOL-$(arch)-Media1/ uyuni-server-stable

5. Refresh the repository list and accept the key:

# zypper ref

6. Install the container tools:

# zypper in mgradm mgrctl mgradm-bash-completion mgrctl-bash-completion uyuni-storage-setup-server

7. From the terminal run the following command as root:

# mgradm install podman

8. Input a password for the CA certificate, an administrative account password and your email for notifications:

# mgradm install podman
3:07PM INF Welcome to mgradm
3:07PM INF Executing command: podman
Password for the CA certificate to generate:
Administrator password:
Administrator's email: admin@example.com

9. The container will take some minutes to deploy.

Once the setup assistant is ready, you will be able to access the WebUI at https://<FQDN>/

From that point you can start working with the Uyuni Server.

Proxy Setup


Hardware and Software Requirements
Requirement Description
openSUSE Tumbleweed Clean installation, up-to-date
Multi-core CPU x86_64
2GB RAM * Minimum for testing and production
50GB Disk Space ** Disk space depends on your channel requirements

**50GB per SUSE/openSUSE product and 360GB per Red Hat Product to be mirrored by the proxy


Quickstart Installation Instructions

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

See the Installation Guide for step-by-step instructions for installing and configuring Uyuni Proxy.

Client Tools


Each supported Operating System has a repository, for all supported architectures:

Reporting Bugs

Submit bugs to the issues tab located at our Github repository.