# Local installation via docker

If you don't have a linux machine to install kube+, it can be quite annoying to setup the device properly to be able to install kube+.
For that reason we provide a docker image for kube+. It spawns up a workspace which has all toolings pre-installed so you can smoothly install kube+.

Nevertheless, at least there are some installed tools needed to run the early preparation steps. This are:

kubectl
docker

# Step 1 - Get kube+

Get the latest kube+ tarball (opens new window) and untar it.

$ tar xvzf kube-plus-latest.tgz
$ cd kube-plus

# Step 2 - Configuration

Configure your config.yml according to this chapter.

# Step 3 - Install via docker

$ grep -A3 module_registry templates/defaults.yml
$ docker login <host> -u <username> -p <password>    # provide the correct values from previous output

# Step 4 - Install via docker

This command starts a docker container which has pre-installed the necessary tools you need to deploy kube+. It mounts your current directory and your kubeconfig into the container so the needed config will be available inside the container.

$ kubectl config current-context     # check your current context where the install will occur. 
$ docker run --rm -ti -w /kube-plus -v `pwd`:/kube-plus -v ~/.kube/config:/root/.kube/config \
cnbb-docker-local.bin.swisscom.com/kube-plus/deploy:v0.3.10 make kube-plus-install

# Step 5 - Test kube+ via Docker

This command starts a docker container which has a a set of pre-installed tools you need to test kube+. It mounts your current directory and your kubeconfig into the container so the needed config will be available inside the container. It will run a custom ruby rspec testsuite to ensure the functionalities of kube+.

$ docker run --rm -ti -w /kube-plus -v `pwd`:/kube-plus -v ~/.kube/config:/root/.kube/config \
cnbb-docker-local.bin.swisscom.com/kube-plus/test:v0.4.10 make kube-plus-test

← Manual installation Install via k8s job →