Error Codes

minikube error codes and strings

Error Strings

“MK_PATCH_NOT_FOUND” (Exit code ExProgramUsage)
minikube could not find a patch for the provided major.minor version

“MK_USAGE” (Exit code ExProgramUsage)
minikube has been passed an incorrect parameter

“MK_USAGE_NO_PROFILE” (Exit code ExProgramUsage)
minikube has no current cluster running

“MK_INTERRUPTED” (Exit code ExProgramConflict)
minikube was interrupted by an OS signal

“MK_WRONG_BINARY_WSL” (Exit code ExProgramUnsupported)
user attempted to run a Windows executable (.exe) inside of WSL rather than using the Linux binary

“MK_UNIMPLEMENTED” (Exit code ExProgramUnsupported)
this feature is unimplemented for whatever reason

“MK_NEW_APICLIENT” (Exit code ExProgramError)
minikube failed to create a new Docker Machine api client

“MK_ADDON_DISABLE” (Exit code ExProgramError)
minikube could not disable an addon, e.g. dashboard addon

“MK_ADDON_ENABLE” (Exit code ExProgramError)
minikube could not enable an addon, e.g. dashboard addon

“MK_ADDON_ENABLE_PAUSED” (Exit code ExProgramConflict)
minikube could not enable an addon on a paused cluster

“MK_ADDON_DISABLE_PAUSED” (Exit code ExProgramConflict)
minikube could not disable an addon on a paused cluster

“MK_ADD_CONFIG” (Exit code ExProgramError)
minikube failed to update internal configuration, such as the cached images config map

“MK_BOOTSTRAPPER” (Exit code ExProgramError)
minikube failed to create a cluster bootstrapper

“MK_CACHE_LIST” (Exit code ExProgramError)
minikube failed to list cached images

“MK_CACHE_LOAD” (Exit code ExProgramError)
minkube failed to cache and load cached images

“MK_COMMAND_RUNNER” (Exit code ExProgramError)
minikube failed to load a Docker Machine CommandRunner

“MK_START_NERDCTLD” (Exit code ExProgramError)
minikube failed to start nerdctld

“MK_COMPLETION” (Exit code ExProgramError)
minikube failed to generate shell command completion for a supported shell

“MK_CONFIG_SET” (Exit code ExProgramError)
minikube failed to set an internal config value

“MK_CONFIG_UNSET” (Exit code ExProgramError)
minikube failed to unset an internal config value

“MK_CONFIG_VIEW” (Exit code ExProgramError)
minikube failed to view current config values

“MK_DEL_CONFIG” (Exit code ExProgramError)
minikube failed to delete an internal configuration, such as a cached image

“MK_DOCKER_SCRIPT” (Exit code ExProgramError)
minikube failed to generate script to activate minikube docker-env

“MK_BIND_FLAGS” (Exit code ExProgramError)
an error occurred when viper attempted to bind flags to configuration

“MK_FORMAT_USAGE” (Exit code ExProgramError)
minkube was passed an invalid format string in the –format flag

“MK_GENERATE_DOCS” (Exit code ExProgramError)
minikube failed to auto-generate markdown-based documentation in the specified folder

“MK_JSON_MARSHAL” (Exit code ExProgramError)
minikube failed to marshal a JSON object

“MK_K8S_CLIENT” (Exit code ExControlPlaneUnavailable)
minikube failed to create a Kubernetes client set which is necessary for querying the Kubernetes API

“MK_LIST_CONFIG” (Exit code ExProgramError)
minikube failed to list some configuration data

“MK_LOG_FOLLOW” (Exit code ExProgramError)
minikube failed to follow or watch minikube logs

“MK_NEW_RUNTIME” (Exit code ExProgramError)
minikube failed to create an appropriate new runtime based on the driver in use

“MK_OUTPUT_USAGE” (Exit code ExProgramError)
minikube was passed an invalid value for the –output command line flag

“MK_RUNTIME” (Exit code ExProgramError)
minikube could not configure the runtime in use, or the runtime failed

“MK_RESERVED_PROFILE” (Exit code ExProgramConflict)
minikube was passed a reserved keyword as a profile name, which is not allowed

“MK_ENV_SCRIPT” (Exit code ExProgramError)
minkube failed to generate script to set or unset minikube-env

“MK_SHELL_DETECT” (Exit code ExProgramError)
minikube failed to detect the shell in use

“MK_STATUS_JSON” (Exit code ExProgramError)
minikube failed to output JSON-formatted minikube status

“MK_STATUS_TEXT” (Exit code ExProgramError)
minikube failed to output minikube status text

“MK_VIEW_EXEC” (Exit code ExProgramError)
minikube failed to execute (i.e. fill in values for) a view template for displaying current config

“MK_VIEW_TMPL” (Exit code ExProgramError)
minikube failed to create view template for displaying current config

“MK_YAML_MARSHAL” (Exit code ExProgramError)
minikube failed to marshal a YAML object

“MK_CREDENTIALS_NOT_FOUND” (Exit code ExProgramNotFound)
minikube could not locate credentials needed to utilize an appropriate service, e.g. GCP

“MK_CREDENTIALS_NOT_NEEDED” (Exit code ExProgramNotFound)
minikube was passed service credentials when they were not needed, such as when using the GCP Auth addon when running in GCE

“MK_SEMVER_PARSE” (Exit code ExProgramError)
minikube found an invalid semver string for kubernetes in the minikube constants

“MK_DAEMONIZE” (Exit code ExProgramError)
minikube was unable to daemonize the minikube process

“RSRC_INSUFFICIENT_CORES” (Exit code ExInsufficientCores)
insufficient cores available for use by minikube and kubernetes

“RSRC_DOCKER_CORES” (Exit code ExInsufficientCores)
insufficient cores available for use by Docker Desktop on Mac

“RSRC_DOCKER_CORES” (Exit code ExInsufficientCores)
insufficient cores available for use by Docker Desktop on Windows

“RSRC_INSUFFICIENT_REQ_MEMORY” (Exit code ExInsufficientMemory)
insufficient memory (less than the recommended minimum) allocated to minikube

“RSRC_INSUFFICIENT_SYS_MEMORY” (Exit code ExInsufficientMemory)
insufficient memory (less than the recommended minimum) available on the system running minikube

“RSRC_INSUFFICIENT_CONTAINER_MEMORY” (Exit code ExInsufficientMemory)
insufficient memory available for the driver in use by minikube

“RSRC_DOCKER_MEMORY” (Exit code ExInsufficientMemory)
insufficient memory available to Docker Desktop on Windows

“RSRC_DOCKER_MEMORY” (Exit code ExInsufficientMemory)
insufficient memory available to Docker Desktop on Mac

“RSRC_INVALID_HYPERV_MEMORY” (Exit code ExResourceError)
invalid memory value for Hyper-V

“RSRC_DOCKER_STORAGE” (Exit code ExInsufficientStorage)
insufficient disk storage available to the docker driver

“RSRC_PODMAN_STORAGE” (Exit code ExInsufficientStorage)
insufficient disk storage available to the podman driver

“RSRC_INSUFFICIENT_STORAGE” (Exit code ExInsufficientStorage)
insufficient disk storage available for running minikube and kubernetes

“HOST_HOME_MKDIR” (Exit code ExHostPermission)
minikube could not create the minikube directory

“HOST_HOME_CHOWN” (Exit code ExHostPermission)
minikube could not change permissions for the minikube directory

“HOST_BROWSER” (Exit code ExHostError)
minikube failed to open the host browser, such as when running minikube dashboard

“HOST_CONFIG_LOAD” (Exit code ExHostConfig)
minikube failed to load cluster config from the host for the profile in use

“HOST_HOME_PERMISSION” (Exit code ExHostPermission)
the current user has insufficient permissions to create the minikube profile directory

“HOST_CURRENT_USER” (Exit code ExHostConfig)
minikube failed to determine current user

“HOST_DEL_CACHE” (Exit code ExHostError)
minikube failed to delete cached images from host

“HOST_KILL_MOUNT_PROC” (Exit code ExHostError)
minikube failed to kill a mount process

“HOST_KUBECONFIG_UPDATE” (Exit code ExHostConfig)
minikube failed to update host Kubernetes resources config

“HOST_KUBECONFIG_DELETE_CTX” (Exit code ExHostConfig)
minikube failed to delete Kubernetes config from context for a given profile

“HOST_KUBECTL_PROXY” (Exit code ExHostError)
minikube failed to launch a kubectl proxy

“HOST_MOUNT_PID” (Exit code ExHostError)
minikube failed to write mount pid

“HOST_PATH_MISSING” (Exit code ExHostNotFound)
minikube was passed a path to a host directory that does not exist

“HOST_PATH_STAT” (Exit code ExHostError)
minikube failed to access info for a directory path

“HOST_PURGE” (Exit code ExHostError)
minikube failed to purge minikube config directories

“HOST_SAVE_PROFILE” (Exit code ExHostConfig)
minikube failed to persist profile config

“HOST_UNSUPPORTED” (Exit code ExHostUnsupported)
Host doesn’t support 9p

“PROVIDER_NOT_FOUND” (Exit code ExProviderNotFound)
minikube could not find a provider for the selected driver

“PROVIDER_UNAVAILABLE” (Exit code ExProviderNotFound)
the host does not support or is improperly configured to support a provider for the selected driver

“DRV_CP_ENDPOINT” (Exit code ExDriverError)
minikube failed to access the driver control plane or API endpoint

“DRV_PORT_FORWARD” (Exit code ExDriverError)
minikube failed to bind container ports to host ports

“DRV_UNSUPPORTED” (Exit code ExDriverUnsupported)
the driver is currently not supported by minikube

“DRV_UNSUPPORTED_MULTINODE” (Exit code ExDriverConflict)
the driver in use does not support multi-node clusters

“DRV_UNSUPPORTED_OS” (Exit code ExDriverUnsupported)
the specified driver is not supported on the host OS

“DRV_UNSUPPORTED_PROFILE” (Exit code ExDriverUnsupported)
the driver in use does not support the selected profile or multiple profiles

“DRV_NOT_FOUND” (Exit code ExDriverNotFound)
minikube failed to locate specified driver

“DRV_NOT_DETECTED” (Exit code ExDriverNotFound)
minikube could not find a valid driver

“DRV_NOT_HEALTHY” (Exit code ExDriverNotFound)
minikube found drivers but none were ready to use

“DRV_DOCKER_NOT_RUNNING” (Exit code ExDriverNotFound)
minikube found the docker driver but the docker service was not running

“DRV_AS_ROOT” (Exit code ExDriverPermission)
the driver in use is being run as root

“DRV_NEEDS_ROOT” (Exit code ExDriverPermission)
the specified driver needs to be run as root

“GUEST_CACHE_LOAD” (Exit code ExGuestError)
minikube failed to load cached images

“GUEST_CERT” (Exit code ExGuestError)
minikube failed to setup certificates

“GUEST_CP_CONFIG” (Exit code ExGuestConfig)
minikube failed to access the control plane

“GUEST_DELETION” (Exit code ExGuestError)
minikube failed to properly delete a resource, such as a profile

“GUEST_IMAGE_LIST” (Exit code ExGuestError)
minikube failed to list images on the machine

“GUEST_IMAGE_LOAD” (Exit code ExGuestError)
minikube failed to pull or load an image

“GUEST_IMAGE_REMOVE” (Exit code ExGuestError)
minikube failed to remove an image

“GUEST_IMAGE_PULL” (Exit code ExGuestError)
minikube failed to pull an image

“GUEST_IMAGE_BUILD” (Exit code ExGuestError)
minikube failed to build an image

“GUEST_IMAGE_SAVE” (Exit code ExGuestError)
minikube failed to push or save an image

“GUEST_IMAGE_PUSH” (Exit code ExGuestError)
minikube failed to push an image

“GUEST_IMAGE_TAG” (Exit code ExGuestError)
minikube failed to tag an image

“GUEST_LOAD_HOST” (Exit code ExGuestError)
minikube failed to load host

“GUEST_MOUNT” (Exit code ExGuestError)
minkube failed to create a mount

“GUEST_MOUNT_COULD_NOT_CONNECT” (Exit code ExGuestError)
mount on guest was unable to connect to host mount server

“GUEST_MOUNT_CONFLICT” (Exit code ExGuestConflict)
minkube failed to update a mount

“GUEST_NODE_ADD” (Exit code ExGuestError)
minikube failed to add a node to the cluster

“GUEST_NODE_DELETE” (Exit code ExGuestError)
minikube failed to remove a node from the cluster

“GUEST_NODE_PROVISION” (Exit code ExGuestError)
minikube failed to provision a node

“GUEST_NODE_RETRIEVE” (Exit code ExGuestNotFound)
minikube failed to retrieve information for a cluster node

“GUEST_NODE_START” (Exit code ExGuestError)
minikube failed to startup a cluster node

“GUEST_PAUSE” (Exit code ExGuestError)
minikube failed to pause the cluster process

“GUEST_PROFILE_DELETION” (Exit code ExGuestError)
minikube failed to delete a machine profile directory

“GUEST_PROVISION” (Exit code ExGuestError)
minikube failed while attempting to provision the guest

“GUEST_PROVISION_CONTAINER_EXITED” (Exit code ExGuestError)
docker container exited prematurely during provisioning

“GUEST_START” (Exit code ExGuestError)
minikube failed to start a node with current driver

“GUEST_STATUS” (Exit code ExGuestError)
minikube failed to get docker machine status

“GUEST_STOP_TIMEOUT” (Exit code ExGuestTimeout)
stopping the cluster process timed out

“GUEST_UNPAUSE” (Exit code ExGuestError)
minikube failed to unpause the cluster process

“GUEST_CHECK_PAUSED” (Exit code ExGuestError)
minikube failed to check if Kubernetes containers are paused

“GUEST_DRIVER_MISMATCH” (Exit code ExGuestConflict)
minikube cluster was created used a driver that is incompatible with the driver being requested

“GUEST_MISSING_CONNTRACK” (Exit code ExGuestUnsupported)
minikube could not find conntrack on the host, which is required from Kubernetes 1.18 onwards

“GUEST_MISSING_CRICTL” (Exit code ExGuestUnsupported)
minikube could not find crictl on the host, which is required from Kubernetes 1.24 onwards

“IF_HOST_IP” (Exit code ExLocalNetworkError)
minikube failed to get the host IP to use from within the VM

“IF_MOUNT_IP” (Exit code ExLocalNetworkError)
minikube failed to parse the input IP address for mount

“IF_MOUNT_PORT” (Exit code ExLocalNetworkError)
minikube failed to parse or find port for mount

“IF_SSH_CLIENT” (Exit code ExLocalNetworkError)
minikube failed to access an ssh client on the host machine

“IF_DEDICATED_NETWORK” (Exit code ExLocalNetworkError)
minikube failed to create a dedicated network

“IF_BOOTPD_FIREWALL” (Exit code ExLocalNetworkError)
minikube failed to populate dchpd_leases file due to bootpd being blocked by firewall

“INET_CACHE_BINARIES” (Exit code ExInternetError)
minikube failed to cache kubernetes binaries for the current runtime

“INET_CACHE_KUBECTL” (Exit code ExInternetError)
minikube failed to cache the kubectl binary

“INET_CACHE_TAR” (Exit code ExInternetError)
minikube failed to cache required images to tar files

“INET_LICENSES” (Exit code ExInternetError)
minikube failed to download licenses

“INET_REPO” (Exit code ExInternetError)
minikube was unable to access main repository and mirrors for images

“INET_REPOS_UNAVAILABLE” (Exit code ExInternetError)
minikube was unable to access any known image repositories

“INET_VERSION_UNAVAILABLE” (Exit code ExInternetUnavailable)
minikube was unable to fetch latest release/version info for minkikube

“INET_VERSION_EMPTY” (Exit code ExInternetConfig)
minikube received invalid empty data for latest release/version info from the server

“RUNTIME_ENABLE” (Exit code ExRuntimeError)
minikube failed to enable the current container runtime

“RUNTIME_CACHE” (Exit code ExRuntimeError)
minikube failed to cache images for the current container runtime

“SSH_AGENT_START” (Exit code ExRuntimeError)
minikube failed to start an ssh-agent when executing docker-env

“SVC_CHECK_TIMEOUT” (Exit code ExSvcTimeout)
service check timed out while starting minikube dashboard

“SVC_TIMEOUT” (Exit code ExSvcTimeout)
minikube was unable to access a service

“SVC_UNREACHABLE” (Exit code ExSvcNotFound)
minikube found that the service has no available pods

“SVC_LIST” (Exit code ExSvcError)
minikube failed to list services for the specified namespace

“SVC_TUNNEL_START” (Exit code ExSvcError)
minikube failed to start a tunnel

“SVC_TUNNEL_STOP” (Exit code ExSvcError)
minikube could not stop an active tunnel

“TUNNEL_ALREADY_RUNNING” (Exit code ExSvcConflict)
another instance of tunnel already running

“SVC_URL_TIMEOUT” (Exit code ExSvcTimeout)
minikube was unable to access the service url

“SVC_NOT_FOUND” (Exit code ExSvcNotFound)
minikube couldn’t find the specified service in the specified namespace

“ENV_DRIVER_CONFLICT” (Exit code ExDriverConflict)
user attempted to use a command that is not supported by the driver currently in use

“ENV_MULTINODE_CONFLICT” (Exit code ExGuestConflict)
user attempted to run a command that is not supported on multi-node setup without some additional configuration

“ENV_PODMAN_UNAVAILABLE” (Exit code ExRuntimeUnavailable)
the podman service was unavailable to the cluster

“SVC_ADDON_UNSUPPORTED” (Exit code ExSvcUnsupported)
user attempted to use an addon that is not supported

“SVC_ADDON_NOT_ENABLED” (Exit code ExProgramConflict)
user attempted to use an addon that is currently not enabled

“K8S_INSTALL_FAILED” (Exit code ExControlPlaneError)
minikube failed to update the Kubernetes cluster

“K8S_INSTALL_FAILED_CONTAINER_RUNTIME_NOT_RUNNING” (Exit code ExRuntimeNotRunning)
minikube failed to update the Kubernetes cluster because the container runtime was unavailable

“K8S_OLD_UNSUPPORTED” (Exit code ExControlPlaneUnsupported)
an outdated Kubernetes version was specified for minikube to use

“K8S_NEW_UNSUPPORTED” (Exit code ExControlPlaneUnsupported)
a too new Kubernetes version was specified for minikube to use

“K8S_FAIL_CONNECT” (Exit code ExInternetError)
error fetching GitHub Kubernetes version list

“K8S_DOWNGRADE_UNSUPPORTED” (Exit code ExControlPlaneUnsupported)
minikube was unable to safely downgrade installed Kubernetes version

“NOT_FOUND_CRI_DOCKERD” (Exit code ExProgramNotFound)

“NOT_FOUND_DOCKERD” (Exit code ExProgramNotFound)

“NOT_FOUND_CNI_PLUGINS” (Exit code ExProgramNotFound)

“NOT_FOUND_SOCKET_VMNET” (Exit code ExProgramNotFound)

Error Codes

Generic Errors

1: ExFailure
2: ExInterrupted

Error codes specific to the minikube program

10: ExProgramError
14: ExProgramUsage
11: ExProgramConflict
15: ExProgramNotFound
16: ExProgramUnsupported
18: ExProgramConfig

Error codes specific to resource limits (exit code layout follows no rules)

20: ExResourceError
23: ExInsufficientMemory
26: ExInsufficientStorage
27: ExInsufficientPermission
29: ExInsufficientCores

Error codes specific to the host

30: ExHostError
31: ExHostConflict
32: ExHostTimeout
34: ExHostUsage
35: ExHostNotFound
36: ExHostUnsupported
37: ExHostPermission
38: ExHostConfig

Error codes specific to remote networking

40: ExInternetError
41: ExInternetConflict
42: ExInternetTimeout
45: ExInternetNotFound
48: ExInternetConfig
49: ExInternetUnavailable

Error codes specific to the libmachine driver

50: ExDriverError
51: ExDriverConflict
52: ExDriverTimeout
54: ExDriverUsage
55: ExDriverNotFound
56: ExDriverUnsupported
57: ExDriverPermission
58: ExDriverConfig
59: ExDriverUnavailable

Error codes specific to the driver provider

60: ExProviderError
61: ExProviderConflict
62: ExProviderTimeout
63: ExProviderNotRunning
65: ExProviderNotFound
66: ExProviderUnsupported
67: ExProviderPermission
68: ExProviderConfig
69: ExProviderUnavailable

Error codes specific to local networking

70: ExLocalNetworkError
71: ExLocalNetworkConflict
72: ExLocalNetworkTimeout
75: ExLocalNetworkNotFound
77: ExLocalNetworkPermission
78: ExLocalNetworkConfig
79: ExLocalNetworkUnavailable

Error codes specific to the guest host

80: ExGuestError
81: ExGuestConflict
82: ExGuestTimeout
83: ExGuestNotRunning
85: ExGuestNotFound
86: ExGuestUnsupported
87: ExGuestPermission
88: ExGuestConfig
89: ExGuestUnavailable

Error codes specific to the container runtime

90: ExRuntimeError
93: ExRuntimeNotRunning
95: ExRuntimeNotFound
99: ExRuntimeUnavailable

Error codes specific to the Kubernetes control plane

100: ExControlPlaneError
101: ExControlPlaneConflict
102: ExControlPlaneTimeout
103: ExControlPlaneNotRunning
105: ExControlPlaneNotFound
106: ExControlPlaneUnsupported
108: ExControlPlaneConfig
109: ExControlPlaneUnavailable

Error codes specific to a Kubernetes service

110: ExSvcError
111: ExSvcConflict
112: ExSvcTimeout
113: ExSvcNotRunning
115: ExSvcNotFound
116: ExSvcUnsupported
117: ExSvcPermission
118: ExSvcConfig
119: ExSvcUnavailable