Self-Managed Shipa with Minikube

Minikube can also be used to quickly install Shipa and start deploying applications



Users can find detailed information on how to install Minikube by using link below:



Virtualbox can be downloaded by using the following link:

Note: Ensure that Virtualbox is installed prior to executing the instructions below.



For newer Macs, you might have to switch the minikube driver to HyperKit.

Can use Homebrew to install HyperKit on your Mac.
brew install hyperkit

After installing MiniKube and Virtualbox, it's time to get a cluster up and running by using the command below:

minikube start --kubernetes-version='v1.21.8' --memory='5gb' --disk-size='20gb' --driver=hyperkit

Once the cluster is running, Add the Shipa Helm chart repo using the following command:

helm repo add shipa-charts

Install Shipa

helm upgrade --install shipa shipa-charts/shipa \
--create-namespace --namespace shipa-system \
--timeout=15m \
[email protected] \
--set=auth.adminPassword=this-is-a-secret \
--set=shipaCluster.ingress.serviceType=ClusterIP \


Install process

Shipa installs its services in the default namespace of your local clusters.

To check its progress, run kubectl get pods.

Once the dashboard-web-1-x service is running, Shipa is ready to be used!

With Shipa installed and running, the next step is to add route to the ngnix ingress. To do this, use the following command:

sudo route -n add -host -net $(minikube ip )


Shipa CLI Download

Users can download the Shipa CLI by using this link

Once the route to ngnix has been added, next add your local Shipa instance as a target to your Shipa CLI:

shipa target add -s shipa-minikube


Self Signed Shipa CA

Depending on your connectivity, you might be asked to use a self signed cert that is generated for a new target e.g shipa-v101 in this case.

By installing the Shipa CLI and adding the Shipa instance as a target, you can run a pair of commands to find the Web UI. By running the login and app list commands, you will have access to the Web UI. The output from app list will provide the dashboard URL.

shipa login
#List Apps
shipa app list

#Output from shipa app list
| Application | Status    | Shipa Managed | Address                            |
| dashboard   | 1 running | true          | http://dashboard.   ↡ |
|             |           |               |                        |

In this case, the dashboard URL is


What’s Next