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 Tumbleweed | 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 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:/Master/images/repo/Uyuni-Server-POOL-$(arch)-Media1/ uyuni-server-devel
In case of using a different host OS (Ubuntu, Debian...), in general anything not based on (open)SUSE products), use the relevant repository from
https://download.opensuse.org/repositories/systemsmanagement:/Uyuni:/Master:/ContainerUtils/
5. Refresh the repository list and accept the key:
# zypper ref
6. Install the product:
# zypper in -t product Uyuni-Server
In case of using a different host OS (Ubuntu, Debian...), in general anything not based on (open)SUSE products), the packages to be installed are:
mgradm
mgrctl
mgradm-bash-completion
podman
uyuni-storage-setup-server
IMPORTANT: podman >= 4.5.0 is required
7. From the terminal run the following command as root:
# mgradm install podman --registry registry.opensuse.org/systemsmanagement/uyuni/master/containerfile
8. Input a password for the CA certificate, an administrative account password and your email for notifications:
2:09PM INF Starting mgradm install podman
2:09PM INF Use of this software implies acceptance of the End User License Agreement.
Password for the CA key to generate:
Confirm the password:
Administrator password:
Confirm the password:
9. 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 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:
- 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 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.