minikube/site/content/en/docs/tutorials/docker_desktop_replacement.md

title	linkTitle	weight	date
Using minikube as Docker Desktop Replacement	Using minikube as Docker Desktop Replacement	1	2022-02-02

Overview

• This guide will show you how to use minikube as a Docker Desktop replacement.

Before You Begin

• This only works with the docker container runtime, not with containerd or crio.

• You need to start minikube with a VM driver instead of docker, such as hyperkit on macOS and hyperv on Windows.

• Alternatively, you can use the [minikube image build]({{< ref "/docs/commands/image#minikube-image-build" >}}) command instead of minikube docker-env and docker build.

Steps

1Install the Docker CLI

{{% tabs %}} {{% mactab %}} {{% tabs %}} {{% tab brew %}} ```shell brew install docker ``` {{% /tab %}} {{% tab Manual %}} 1. Download the static binary archive. Go to https://download.docker.com/mac/static/stable/ and select `x86_64` (for Mac on Intel chip) or `aarch64` (for Mac on Apple silicon), and then download the `.tgz` file relating to the version of Docker Engine you want to install.

2. Extract the archive using the tar utility. The docker binary is extracted.

tar xzvf /path/to/<FILE>.tar.gz

3. Clear the extended attributes to allow it run.

sudo xattr -rc docker

4. Move the binary to a directory on your executable path, such as /usr/local/bin/.

sudo cp docker/docker /usr/local/bin/

{{% /tab %}} {{% /tabs %}} {{% /mactab %}} {{% windowstab %}} {{% tabs %}} {{% tab Chocolatey %}} Please Note: The docker engine requires the Windows Features: Containers and Microsoft-Hyper-V to be installed in order to function correctly. You can install these with the chocolatey command:

choco install Containers Microsoft-Hyper-V --source windowsfeatures

1. Install docker-engine

choco install docker-engine

2. This package creates the group docker-users and adds the installing user to it. In order to communicate with docker you will need to log out and back in. {{% /tab %}} {{% tab Manual %}}

3. Download the static binary archive. Go to https://download.docker.com/win/static/stable/x86_64 and select the latest version from the list.

4. Run the following PowerShell commands to install and extract the archive to your program files:

Expand-Archive /path/to/<FILE>.zip -DestinationPath $Env:ProgramFiles

3. Add the path to the Docker CLI binary (C:\Program Files\Docker) to the PATH environment variable, guide to setting environment variables in Windows.

4. Restart Windows for the PATH change to take effect. {{% /tab %}} {{% /tabs %}} {{% /windowstab %}} {{% /tabs %}}

2Start minikube

Start minikube with a VM driver and `docker` container runtime if not already running.

minikube start --container-runtime=docker --vm=true

3Point Docker CLI to minikube

Use the `minikube docker-env` command to point your terminal's Docker CLI to the Docker instance inside minikube.

Note: the default profile name is minikube

{{% tabs %}} {{% tab "bash/zsh" %}}

eval $(minikube -p <profile> docker-env)

{{% /tab %}} {{% tab PowerShell %}}

& minikube -p <profile> docker-env --shell powershell | Invoke-Expression

{{% /tab %}} {{% tab cmd %}}

@FOR /f "tokens=*" %i IN ('minikube -p <profile> docker-env --shell cmd') DO @%i

{{% /tab %}} {{% tab fish %}}

minikube -p <profile> docker-env | source

{{% /tab %}} {{% tab tcsh %}}

eval `minikube -p <profile> docker-env`

{{% /tab %}} {{% /tabs %}}