ssh

Overview

This document is written for system integrators who wish to run minikube within a customized VM environment. The ssh driver allows advanced minikube users to skip VM creation, allowing minikube to be run on a user-supplied VM.

Requirements

A Linux VM with the following:

• systemd or OpenRC
• a container runtime, such as Docker or CRIO
• cri-dockerd (if using Kubernetes +v1.24 & docker container-runtime)

This VM must also meet the kubeadm requirements, such as:

• 2 CPU’s
• 2GB RAM
• iptables (in legacy mode)
• conntrack
• crictl
• cni-plugins
• SELinux permissive
• cgroups v1 (v2 is not yet supported by Kubernetes)

Usage

The ssh driver requires the IP address of the VM to use.

minikube start --driver=ssh --ssh-ip-address=vm.example.com

Issues

• Full list of open ‘ssh’ driver issues

Troubleshooting

• Run minikube start --alsologtostderr -v=4 to debug crashes