Launch a local Kubernetes cluster via Docker Compose
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

This project will not be updated to support Kubernetes 1.2. It's easier to start Kubernetes from version 1.2.0 onwards. Only one docker run command is required. Therefore it doesn't really make sense to use Docker Compose any more.

I will be deprecating this project in favour of kid, which is a single Bash script that you can place in your $PATH and call from anywhere.

Launch Kubernetes using Docker via Docker Compose

The following will also be set up for you:

Starting Kubernetes on Linux

On Linux we'll run Kubernetes using a local Docker Engine. You will also need Docker Compose as well as the kubectl tool. To launch the cluster:


Starting Kubernetes on OS X

On OS X we'll launch Kubernetes inside a boot2docker VM via Docker Machine. You will need to have Docker Machine (v0.5.0 or newer), Docker Compose, and the kubectl tool installed locally. First start your boot2docker VM:

docker-machine start <name>
eval "$(docker-machine env $(docker-machine active))"

Then, launch the Kubernetes cluster in boot2docker via Docker Machine:


The script will set up port forwarding so that you can use kubectl locally without having to ssh into boot2docker.

Checking if Kubernetes Is Running

kubectl cluster-info
Kubernetes master is running at http://localhost:8080
KubeUI is running at http://localhost:8080/api/v1/proxy/namespaces/kube-system/services/kube-ui

Accessing Kube UI

You can access Kube UI at http://localhost:8080/ui.

To destroy the cluster


This will also remove any services, replication controllers and pods that are running in the cluster.