United Manufacturing Hub

Setting up UMH on RHEL / Rocky Linux in Proxmox

Discover how to install the United Manufacturing Hub (UMH) on Red Hat Enterprise Linux (RHEL). It will be installed as a VM running in Proxmox.

Setting up UMH on RHEL / Rocky Linux in Proxmox

In this guide, we'll use Rocky Linux. It should work just like RHEL, but we can't promise it will always do so.


  1. In Proxmox, make a VM with 4 cores and 8GB of RAM. Make sure to choose 'host' as the CPU type.

  2. Make the VM and start it. Choose to install Rocky Linux 9.2.

  3. Follow the setup steps. Pick your hard drive and give the root password. Then, hit “Start Installation” to go on.

  4. Restart once the setup is done.

  5. Sign in as root with your password. Type ip addr to find out your IP address.

  6. Use SSH to connect to it. You'll need the IP and your login info.

  7. Type dnf -y install podman to set up Docker / Podman.

  8. Type curl -sfL https://get.k3s.io | sh - to set up k3s.

  9. Type curl -sfL https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3 | sh - to set up Helm.

  10. Type helm repo add united-manufacturing-hub https://repo.umh.app/ to add UMH to your Helm repo.

  11. Type kubectl create namespace united-manufacturing-hub to make a Kubernetes namespace.

  12. Type helm install united-manufacturing-hub united-manufacturing-hub/united-manufacturing-hub --kubeconfig /etc/rancher/k3s/k3s.yaml -n united-manufacturing-hub` to set up the UMH.

  13. Type the following to allow outside access to the Kubernetes Management Port and allow the Kubernetes pods to see each other:

    firewall-cmd --permanent --add-port=6443/tcp
    firewall-cmd --permanent --zone=trusted --add-source= # pods
    firewall-cmd --permanent --zone=trusted --add-source= # services
    firewall-cmd --reload

    Remember, you need to open the port for any services you want to use, like 1883 for MQTT.

    If you do not use the commands on line 2 and 3, you will get an error like dial tcp connect: no route to host

  14. You're all set! You can now use it and add it to Lens: https://umh.docs.umh.app/docs/production-guide/installation/flatcar-installation-bare-metal/#import-the-cluster-configuration

Fun-fact: our recommended operating system "flatcar" is actually a fork of CoreOS, the Operating System behind OpenShift, and its based on RHEL. So you can leverage most of our configuration and provisioning tools and only need to make here and there some smaller changes (e.g., the firewall-cmd commands).

Stay up-to-date

Subscribe to the UMH Learning Hub Newsletter to receive the latest updates and gain early access to our blog posts.