Warning
Never use the Uyuni Development Version for production systems in any way!
Uyuni Development Version is updated with each commit to the Git Repository, and it has the following know limitations:
- It can break at any moment
- Upating to newer development versions does not work
- Migrating to Stable is not supported
Documentation
The latest documentation is listed in the server's WebUI navigation after installation.
Server Setup
Hardware and Software Requirements
Requirement | Description |
---|---|
openSUSE Leap Micro 5.5 | Clean installation, up-to-date |
Multi-core CPU | x86_64 or aarch64 |
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 Leap Micro 5.5:
# transactional update
2. Reboot the system
3. Configure a resolvable fully qualified domain name (FQDN)
4. Enter the transactional shell:
# transactional-update shell
5. Add the Uyuni Server repository:
# zypper ar https://download.opensuse.org/repositories/systemsmanagement:/Uyuni:/Master/images/repo/Uyuni-Server-POOL-$(arch)-Media1/ uyuni-server-devel
6. Refresh the repository list and accept the key:
# zypper ref
7. Install the container tools:
# zypper in mgradm mgrctl mgradm-bash-completion mgrctl-bash-completion
8. Reboot the host
9. From the terminal run the following command as root:
# mgradm install podman
10. 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
11. The container will take some minutes to deploy.
Once the setup assistant is ready, you will be able to access the WebUI athttps://<FQDN>/
From that point you can start working with the Uyuni Server.
Proxy Setup
Hardware and Software Requirements
Requirement | Description |
---|---|
openSUSE Leap Micro 5.5 | 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:
- openSUSE Leap 15.* (x86_64, aarch64)
- openSUSE Leap Micro 5.* (x86_64, aarch64)
- SLE 12 (x86_64, pcc64le, s390x, aarch64)
- SLE 15 (x86_64, pcc64le, s390x, aarch64)
- SL Micro 6 (x86_64, s390x, aarch64)
- RHEL, CentOS, Oracle Linux and SLES ES 7 (x86_64, ppc64le)
- RHEL, CentOS, Oracle Linux and SLES ES 8 (x86_64, aarch64)
- Amazon Linux 2 (x86_64, aarch64)
- Alibaba Linux 2 (x86_64, aarch64)
- AlmaLinux 8 (x86_64, aarch64)
- openEuler 22.03 (x86_64, aarch64)
- Rocky Linux 8 (x86_64, aarch64)
- RHEL, Oracle, AlmaLinux and Rocky Linux 9 (x86_64, ppc64le, aarch64, s390x)
- Oracle Linux (x86_64, ppc64le, aarch64)
- Amazon Linux 2023 (x86_64, aarch64)
- Ubuntu 20.04 (x86_64)
- Ubuntu 22.04 (x86_64)
- Ubuntu 24.04 (x86_64)
- Debian 11 (x86_64, aarch64, armv7l, i586, ppc64le, s390x)
- Debian 12 (x86_64, aarch64, armv7l, i586, ppc64le, s390x)
- Raspberry Pi OS 12 (arm64, armhf)
Reporting Bugs
Submit bugs to the issues tab located at our Github repository.