# kubernetes/minikube architecture

> Architecture diagram of the GitHub repository kubernetes/minikube, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kubernetes/minikube
- Repository: https://github.com/kubernetes/minikube

## Overview

minikube is a cross-platform tool for running local Kubernetes clusters. The main user workflow starts at the CLI, loads cluster configuration, creates and provisions a host through a selected driver, then bootstraps Kubernetes. Users can add cluster services and reach them through service URLs or tunnels; other documented capabilities include addons, persistent volumes, mounts, dashboard access, and multi-cluster profiles. The graph combines excerpted call sites and source-index references with README-documented capabilities; dashed, uncited links mark relationships whose implementation was not sampled.

Main entry points: [`cmd/minikube/cmd/start.go`](https://github.com/kubernetes/minikube/blob/master/cmd/minikube/cmd/start.go) (Cluster Commands), [`pkg/minikube/machine/client.go`](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/machine/client.go) (Machine API), [`cmd/minikube/cmd/service.go`](https://github.com/kubernetes/minikube/blob/master/cmd/minikube/cmd/service.go) (Service Command), [`cmd/minikube/main.go`](https://github.com/kubernetes/minikube/blob/master/cmd/minikube/main.go) (Command CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and Configuration"]
  node_cli["Command CLI<br/>[main.go]"]
  node_commands["Cluster Commands<br/>[start.go]"]
  node_config["Cluster Config<br/>[config.go]"]
  node_profiles["Cluster Profiles<br/>[profile.go]"]
end

subgraph group_host["Host Lifecycle"]
  node_machine["Machine API<br/>[client.go]"]
  node_drivers["Host Drivers<br/>[init.go]"]
  node_virtualbox["VirtualBox Driver<br/>[virtualbox.go]"]
  node_rpc["RPC Driver Client<br/>[client_driver.go]"]
  node_ssh["SSH Client<br/>[client.go]"]
  node_provision["Host Provisioning<br/>[provision.go]"]
  node_network["Host Networking<br/>[network.go]"]
end

subgraph group_cluster["Kubernetes Cluster"]
  node_bootstrap["Kubernetes Bootstrap<br/>[bootstrapper.go]"]
  node_runtime["Container Runtime<br/>[cruntime.go]"]
  node_addons["Addons<br/>[addons_gcpauth.go]"]
  node_storage["Storage Classes<br/>[storageclass.go]"]
  node_storageprovisioner["Volume Provisioner"]
  node_kapi["Kubernetes API Client<br/>[kapi.go]"]
end

subgraph group_access["Cluster Access"]
  node_servicecmd["Service Command<br/>[service.go]"]
  node_service["Service Discovery<br/>[service.go]"]
  node_tunnel["Service Tunnel<br/>[service_tunnel.go]"]
  node_tunnelmanager["Tunnel Manager<br/>[tunnel_manager.go]"]
  node_mount["Filesystem Mounts<br/>[mount.go]"]
  node_dashboard["Dashboard Access<br/>[dashboard.go]"]
  node_image["Image Management<br/>[image.go]"]
end

node_user(("User"))

node_user -->|"runs"| node_cli
node_cli -->|"dispatches"| node_commands
node_commands -.->|"loads host"| node_machine
node_commands -.->|"reads config"| node_config
node_machine -->|"selects driver"| node_drivers
node_drivers -.->|"registers"| node_virtualbox
node_machine -.->|"uses RPC"| node_rpc
node_machine -->|"provisions host"| node_provision
node_provision -.->|"configures over SSH"| node_ssh
node_commands -.->|"starts cluster"| node_bootstrap
node_bootstrap -.->|"configures runtime"| node_runtime
node_commands -.->|"manages addons"| node_addons
node_addons -->|"sets default class"| node_storage
node_storage -->|"creates API client"| node_kapi
node_storageprovisioner -.->|"provides volumes"| node_user
node_servicecmd -->|"gets service URLs"| node_service
node_service -->|"queries cluster"| node_kapi
node_servicecmd -->|"starts service tunnel"| node_tunnel
node_servicecmd -->|"checks network"| node_network
node_tunnelmanager -->|"uses machine API"| node_machine
node_commands -.->|"mounts files"| node_mount
node_user -.->|"opens dashboard"| node_dashboard
node_commands -.->|"manages images"| node_image
node_commands -.->|"selects profile"| node_profiles

click node_cli "https://github.com/kubernetes/minikube/blob/master/cmd/minikube/main.go"
click node_commands "https://github.com/kubernetes/minikube/blob/master/cmd/minikube/cmd/start.go"
click node_config "https://github.com/kubernetes/minikube/blob/master/pkg/minikube/config/config.go"
click node_machine "https://github.com/kubernetes/minikube/blob/master/pkg/minikube/machine/client.go"
click node_drivers "https://github.com/kubernetes/minikube/blob/master/pkg/minikube/registry/drvs/init.go"
click node_virtualbox "https://github.com/kubernetes/minikube/blob/master/pkg/drivers/virtualbox/virtualbox.go"
click node_rpc "https://github.com/kubernetes/minikube/blob/master/pkg/libmachine/drivers/rpcdriver/client_driver.go"
click node_ssh "https://github.com/kubernetes/minikube/blob/master/pkg/libmachine/ssh/client.go"
click node_provision "https://github.com/kubernetes/minikube/blob/master/pkg/provision/provision.go"
click node_bootstrap "https://github.com/kubernetes/minikube/blob/master/pkg/minikube/bootstrapper/bootstrapper.go"
click node_runtime "https://github.com/kubernetes/minikube/blob/master/pkg/minikube/cruntime/cruntime.go"
click node_addons "https://github.com/kubernetes/minikube/blob/master/pkg/addons/addons_gcpauth.go"
click node_storage "https://github.com/kubernetes/minikube/blob/master/pkg/minikube/storageclass/storageclass.go"
click node_storageprovisioner "https://github.com/kubernetes/minikube/blob/master/pkg/storage/storage_provisioner.go"
click node_kapi "https://github.com/kubernetes/minikube/blob/master/pkg/kapi/kapi.go"
click node_network "https://github.com/kubernetes/minikube/blob/master/pkg/network/network.go"
click node_servicecmd "https://github.com/kubernetes/minikube/blob/master/cmd/minikube/cmd/service.go"
click node_service "https://github.com/kubernetes/minikube/blob/master/pkg/minikube/service/service.go"
click node_tunnel "https://github.com/kubernetes/minikube/blob/master/pkg/minikube/tunnel/kic/service_tunnel.go"
click node_tunnelmanager "https://github.com/kubernetes/minikube/blob/master/pkg/minikube/tunnel/tunnel_manager.go"
click node_mount "https://github.com/kubernetes/minikube/blob/master/pkg/minikube/cluster/mount.go"
click node_dashboard "https://github.com/kubernetes/minikube/blob/master/cmd/minikube/cmd/dashboard.go"
click node_image "https://github.com/kubernetes/minikube/blob/master/pkg/minikube/image/image.go"
click node_profiles "https://github.com/kubernetes/minikube/blob/master/pkg/minikube/config/profile.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_commands,node_config,node_profiles,node_user toneBlue
class node_machine,node_drivers,node_virtualbox,node_rpc,node_ssh,node_provision,node_network toneAmber
class node_bootstrap,node_runtime,node_addons,node_storage,node_storageprovisioner,node_kapi toneMint
class node_servicecmd,node_service,node_tunnel,node_tunnelmanager,node_mount,node_dashboard,node_image toneRose
```

## Components

### CLI and Configuration

- [Command CLI](https://github.com/kubernetes/minikube/blob/master/cmd/minikube/main.go): `cmd/minikube/main.go`
- [Cluster Commands](https://github.com/kubernetes/minikube/blob/master/cmd/minikube/cmd/start.go): `cmd/minikube/cmd/start.go`
- [Cluster Config](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/config/config.go): `pkg/minikube/config/config.go`
- [Cluster Profiles](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/config/profile.go): `pkg/minikube/config/profile.go`

### Host Lifecycle

- [Machine API](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/machine/client.go): `pkg/minikube/machine/client.go`
- [Host Drivers](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/registry/drvs/init.go): `pkg/minikube/registry/drvs/init.go`
- [VirtualBox Driver](https://github.com/kubernetes/minikube/blob/master/pkg/drivers/virtualbox/virtualbox.go): `pkg/drivers/virtualbox/virtualbox.go`
- [RPC Driver Client](https://github.com/kubernetes/minikube/blob/master/pkg/libmachine/drivers/rpcdriver/client_driver.go): `pkg/libmachine/drivers/rpcdriver/client_driver.go`
- [SSH Client](https://github.com/kubernetes/minikube/blob/master/pkg/libmachine/ssh/client.go): `pkg/libmachine/ssh/client.go`
- [Host Provisioning](https://github.com/kubernetes/minikube/blob/master/pkg/provision/provision.go): `pkg/provision/provision.go`
- [Host Networking](https://github.com/kubernetes/minikube/blob/master/pkg/network/network.go): `pkg/network/network.go`

### Kubernetes Cluster

- [Kubernetes Bootstrap](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/bootstrapper/bootstrapper.go): `pkg/minikube/bootstrapper/bootstrapper.go`
- [Container Runtime](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/cruntime/cruntime.go): `pkg/minikube/cruntime/cruntime.go`
- [Addons](https://github.com/kubernetes/minikube/blob/master/pkg/addons/addons_gcpauth.go): `pkg/addons/addons_gcpauth.go`
- [Storage Classes](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/storageclass/storageclass.go): `pkg/minikube/storageclass/storageclass.go`
- [Volume Provisioner](https://github.com/kubernetes/minikube/blob/master/pkg/storage/storage_provisioner.go): `pkg/storage/storage_provisioner.go`
- [Kubernetes API Client](https://github.com/kubernetes/minikube/blob/master/pkg/kapi/kapi.go): `pkg/kapi/kapi.go`

### Cluster Access

- [Service Command](https://github.com/kubernetes/minikube/blob/master/cmd/minikube/cmd/service.go): `cmd/minikube/cmd/service.go`
- [Service Discovery](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/service/service.go): `pkg/minikube/service/service.go`
- [Service Tunnel](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/tunnel/kic/service_tunnel.go): `pkg/minikube/tunnel/kic/service_tunnel.go`
- [Tunnel Manager](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/tunnel/tunnel_manager.go): `pkg/minikube/tunnel/tunnel_manager.go`
- [Filesystem Mounts](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/cluster/mount.go): `pkg/minikube/cluster/mount.go`
- [Dashboard Access](https://github.com/kubernetes/minikube/blob/master/cmd/minikube/cmd/dashboard.go): `cmd/minikube/cmd/dashboard.go`
- [Image Management](https://github.com/kubernetes/minikube/blob/master/pkg/minikube/image/image.go): `pkg/minikube/image/image.go`

### Other components

- **User**

## Connections

- User → Command CLI: runs (evidence: `cmd/minikube/main.go`)
- Command CLI → Cluster Commands: dispatches (evidence: `cmd/minikube/main.go`)
- Cluster Commands → Machine API: loads host
- Cluster Commands → Cluster Config: reads config
- Machine API → Host Drivers: selects driver (evidence: `pkg/minikube/machine/client.go`)
- Host Drivers → VirtualBox Driver: registers
- Machine API → RPC Driver Client: uses RPC
- Machine API → Host Provisioning: provisions host (evidence: `pkg/minikube/machine/client.go`)
- Host Provisioning → SSH Client: configures over SSH
- Cluster Commands → Kubernetes Bootstrap: starts cluster
- Kubernetes Bootstrap → Container Runtime: configures runtime
- Cluster Commands → Addons: manages addons
- Addons → Storage Classes: sets default class
- Storage Classes → Kubernetes API Client: creates API client (evidence: `pkg/minikube/storageclass/storageclass.go`)
- Volume Provisioner → User: provides volumes
- Service Command → Service Discovery: gets service URLs (evidence: `cmd/minikube/cmd/service.go`)
- Service Discovery → Kubernetes API Client: queries cluster (evidence: `pkg/minikube/service/service.go`)
- Service Command → Service Tunnel: starts service tunnel (evidence: `cmd/minikube/cmd/service.go`)
- Service Command → Host Networking: checks network (evidence: `cmd/minikube/cmd/service.go`)
- Tunnel Manager → Machine API: uses machine API (evidence: `pkg/minikube/tunnel/tunnel_manager.go`)
- Cluster Commands → Filesystem Mounts: mounts files
- User → Dashboard Access: opens dashboard (evidence: `README.md`)
- Cluster Commands → Image Management: manages images
- Cluster Commands → Cluster Profiles: selects profile
