Skip to main content


To get started quickly, we recommend to run VILLAS in a small Kubernetes cluster.


There are dedicated installation instructions for VILLASnode in case you only want to use the simulation gateway instead of the full framework.

For beginners, we recommend to start looking at VILLASnode first.

You can run the full set of VILLASframework components pre-configured in a Kubernetes cluster using the Helm chart.



For small tests and beginners we recommend a local Minikube setup.

  1. Install Minikube
  2. Install Helm
  3. Start Minikube:
minikube start
  1. Enable the Ingress controller in your minikube cluster:
minikube addons enable ingress

Helm Chart

To deloy the Helm chart you must first add the FEIN e.V. chart repository:

helm repo add fein
helm repo update

Create a minimal chart configuration file named values.yaml with the following contents: Please have a look at the charts default values for more details about the available configuration options.


In this guide we assume the host running Minikube is accessible via the local IP address

Please make sure to update the setting with a resolvable hostname of the machine running Minikube or update the name it with the real IP address as shown below.

username: admin

# please to change to a secure password
password: VillasTest1234

port: 8080

username: admin
password: vieQuoo2sieDahHee8ohM5aThaibiPei
erlangCookie: iKpbgHPsHAj8x58kzFWVT23xahSQ03Vw

Once the configuration file has been prepared, start the installation with the following command:

helm install -f values.yaml villas fein/villas

Access the application

  1. Keep the following command in a terminal running in a background terminal:
minikube kubectl -- -n ingress-nginx port-forward svc/ingress-nginx-controller 8080:80 --address=''

Once the installation has completed, you can visit the VILLASweb interface at the following address: Please use the username / password from above (admin / VillasTest1234) to login.