Home KubernetesInstall Minikube on Ubuntu 22.04 and Deploy Your First Application

Install Minikube on Ubuntu 22.04 and Deploy Your First Application

by Knowledge Base Linux
Install Minikube on Ubuntu 22.04 and — Install Minikube on Ubuntu 22.04 and Deploy Your First Application

Learning Kubernetes is far easier when you can experiment freely without a cloud bill. Minikube runs a complete single-node Kubernetes cluster on your own machine — perfect for learning, testing manifests, and developing before you deploy to production. In this guide you will install Minikube Ubuntu 22.04 from the official binary, start a local cluster using the Docker driver, and deploy your first application with kubectl. Every command below is tested against current releases.

Local Kubernetes cluster created when you install Minikube Ubuntu for development

Prerequisites – Install Minikube on Ubuntu 22.04 and

  • A machine or VM running Ubuntu 22.04 LTS (64-bit) with at least 2 CPUs, 2 GB of free RAM, and 20 GB of free disk space.
  • Docker Engine installed and running — Minikube’s Docker driver runs the cluster inside a container. Follow our guide to install Docker on Ubuntu 22.04 first if needed.
  • A non-root user that belongs to the docker group (so Minikube can talk to the Docker daemon without sudo). If you are working on a remote server, see how to SSH into a Linux server.
  • curl installed: sudo apt-get install -y curl.

Important: never run minikube start as root — the Docker driver explicitly refuses root privileges.

Step 1: Install kubectl – Install Minikube on Ubuntu 22.04 and

kubectl is the command-line tool you use to talk to any Kubernetes cluster, including Minikube’s. Download the latest stable binary from the official Kubernetes release server and install it:

curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
kubectl version --client

The last command should print something like Client Version: v1.3x.x, confirming the client is ready.

Step 2: Install Minikube on Ubuntu

Now download the official Minikube binary and place it on your PATH. This is the entire installation — no package manager required:

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube
rm minikube-linux-amd64
minikube version

You should see output like minikube version: v1.3x.x. Congratulations — the install Minikube Ubuntu step is done, and you have not touched a single system package beyond placing two binaries.

Step 3: Start a Local Cluster With the Docker Driver

Minikube supports several drivers (Docker, KVM, VirtualBox), but Docker is the simplest on Ubuntu 22.04: the whole cluster runs inside a privileged container, with no VM overhead. Start the cluster and make Docker the default driver so you never have to repeat the flag:

minikube start --driver=docker
minikube config set driver docker

The first start takes a few minutes while Minikube pulls the base image and bootstraps Kubernetes. On success you will see Done! kubectl is now configured to use "minikube" cluster. Verify the node is ready:

minikube status
kubectl get nodes

Expected output:

NAME       STATUS   ROLES           AGE   VERSION
minikube   Ready    control-plane   2m    v1.3x.x

On machines with limited RAM you can size the cluster explicitly, for example minikube start --driver=docker --cpus=2 --memory=4g.

Step 4: Deploy Your First Application on Minikube

With the cluster running, deploy an Nginx web server. This creates a Deployment (which keeps your pods running) and a Service (which exposes them on the network):

kubectl create deployment nginx --image=nginx
kubectl expose deployment nginx --type=NodePort --port=80

Watch the pod come up:

kubectl get pods -w

Press Ctrl+C once the pod shows Running. A NodePort service assigns a high port on the node — check it with:

kubectl get svc nginx

Step 5: Access the Application

Minikube can open a tunnel to the service and print its URL, which works even when the cluster runs inside Docker on a remote server:

minikube service nginx --url

Copy the printed URL (for example http://192.168.49.2:31000) and fetch it:

curl $(minikube service nginx --url)

You should receive Nginx’s “Welcome to nginx!” HTML page — your first application is live on your local Kubernetes cluster.

Step 6: Scale Up and Clean Up

Kubernetes makes scaling trivial. Grow the deployment to three replicas and watch the new pods schedule:

kubectl scale deployment nginx --replicas=3
kubectl get pods

When you are finished experimenting, pause the cluster to free resources, or delete it entirely for a fresh start later:

minikube stop      # pause the cluster, keep everything
minikube start     # resume it later
minikube delete    # remove the cluster completely

Troubleshooting: Common Errors When You Install Minikube on Ubuntu

1. “The docker driver should not be used with root privileges”

You ran minikube start as root or with sudo. Switch to a regular user that is in the docker group (sudo usermod -aG docker $USER, then log out and back in), and never prefix minikube commands with sudo.

2. “Cannot connect to the Docker daemon” during minikube start

The Docker service is not running, or your user cannot reach it. Fix both:

sudo systemctl enable --now docker
sudo usermod -aG docker $USER
newgrp docker
docker ps

If docker ps works, retry minikube start --driver=docker.

3. minikube start hangs at “Pulling base image”

This is usually a slow network or a full disk. Check free space with df -h / (you need several GB), then delete any half-created cluster and retry with modest resources:

minikube delete
minikube start --driver=docker --cpus=2 --memory=4g

4. kubectl reports “connection refused” or talks to the wrong cluster

Minikube writes its cluster credentials to ~/.kube/config. If another tool overwrote the current context, switch back explicitly:

kubectl config use-context minikube
kubectl cluster-info

Conclusion

You have learned how to install Minikube Ubuntu 22.04 from the official binaries, start a single-node Kubernetes cluster with the Docker driver, and deploy, expose, access, and scale your first application. This local setup is ideal for practicing deployments, services, and ConfigMaps before touching production infrastructure. Useful next steps: enable the ingress and metrics-server addons (minikube addons enable ingress), write your own Deployment YAML instead of imperative commands, and explore minikube dashboard for a visual overview. The authoritative reference for everything covered here is the official Minikube getting-started documentation.

You may also like

KbLinux

Typically replies within a day

Hello, Welcome to the site. Please click below button for chatting me through Telegram.