< go back


Never use the Uyuni Development Version for production systems in any way!

Uyuni Development Version is updated with each commit to the Git Repository, it can break at any moment, and currently migrating to Stable is not supported!


You will find the documentation at the Server WebUI after it is installed and ready.

Reporting bugs

Use our GitHub repository.

Please always make sure the issue was not reported before by having a look at those that are already created.




  • A clean openSUSE Leap 42.3 installation, fully updated
  • Multi-core x86_64 CPU
  • At least 4GB of RAM for testing (for a production enviroment you would need between 16 and 32GB)
  • 100GB of free disk space + 50GB per SUSE/openSUSE product and 100GB per Red Hat Product


All commands are to be run as root or with sudo

  1. Make sure your openSUSE Leap 42.3 is updated:
    zypper update
  2. Configure a resolvable fully quallified domain name with Yast2 > System > Netwok Settings > Hostname/DNS (if your DNS does not resolve your FQDN, check Assign Hostname to Loopback IP, but you will need to configure the clients to resolve the Server's hostname somehow)
  3. Add the repository for the server:
    zypper ar uyuni-server-devel
  4. Refresh metadata from the repositories:
    zypper refresh
  5. Install the pattern for the Uyuni server:
    zypper in patterns-uyuni_server
  6. Run Yast2 and to Network Services > Uyuni Setup
  7. Follow the setup assistant
  8. Once the setup assistant is ready, you will be able to access the WebUI at https://<FQDN>/ (if FQDN is resolvable by DNS) or https://<IP_ADDRESS>/ if not
  9. From that point you can start working with the Uyuni Server



  • A clean openSUSE Leap 42.3 installation, fully upgraded
  • At least 2GB of RAM
  • 50GB of disk space per channel


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.

Client Tools

These are the repositories: