Building Kubernetes Minikube - linux-on-ibm-z/docs GitHub Wiki

Building Kubernetes Minikube

Kubernetes Minikube binaries are available and the instructions provided below specify the steps to install the version 1.38.1 on Linux on IBM Z.

General Notes:

When following the steps below please use a standard permission user unless otherwise specified.
A directory /<source_root>/ will be referred to in these instructions, this is a temporary writable directory anywhere you'd like to place it.
- Instructions to install Docker can be found here
  - Docker needs to be configured correctly with systemd for minikube to successfully start.
  - Information on configuring the docker systemd unit files to map to the binaries can be found here

1. Install Dependencies

RHEL 8.10
```
sudo yum install -y wget curl git make
```
RHEL (9.6, 9.7, 10.0, 10.1)
```
sudo yum install -y wget curl git make
```

SLES (15 SP7, 16)

sudo zypper install -y wget curl git make

Ubuntu (22.04, 24.04, 25.10)

sudo apt-get update
sudo apt-get install -y wget curl git make

2. Install Minikube and Kubectl

cd $SOURCE_ROOT
export KUBERNETES_VERSION=v1.34.8
curl -LO https://github.com/kubernetes/minikube/releases/download/v1.38.1/minikube-linux-s390x && sudo install minikube-linux-s390x /usr/bin/minikube && rm -rf minikube-linux-s390x
curl -LO https://dl.k8s.io/$KUBERNETES_VERSION/bin/linux/s390x/kubectl && chmod +x kubectl &&  sudo cp kubectl /usr/bin/ && rm -rf kubectl

3. Start Minikube (Optional)

minikube start --driver=docker --kubernetes-version=$KUBERNETES_VERSION

Note:

Above command will start a single kubernetes cluster. The cluster can be viewed using the following command:

kubectl get pods --all-namespaces

Output should look similar to this:

NAMESPACE     NAME                               READY   STATUS    RESTARTS   AGE
kube-system   coredns-bd6b6df9f-qwfmk            1/1     Running   0          12s
kube-system   etcd-minikube                      1/1     Running   0          25s
kube-system   kube-apiserver-minikube            1/1     Running   0          27s
kube-system   kube-controller-manager-minikube   1/1     Running   0          24s
kube-system   kube-proxy-9pw8f                   1/1     Running   0          12s
kube-system   kube-scheduler-minikube            1/1     Running   0          24s
kube-system   storage-provisioner                1/1     Running   0          24s

For additional insight into your cluster state, minikube bundles the Kubernetes Dashboard, allowing you to get easily acclimated to your new environment: