Setting up UMH on RHEL / Rocky Linux in Proxmox

Instructions

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=10.42.0.0/16 # pods
    firewall-cmd --permanent --zone=trusted --add-source=10.43.0.0/16 # 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 10.42.0.80:9092: 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).