Creating a standalone instance of Eclipse Kapua using Docker containers

March 15, 2018

Today I start with taking a deeper look at Eclipse Kapua. It is a modular IoT cloud platform to manage and integrate devices and their data.

My goal for the next weeks will be to demonstrate a multi-tenant capable installation of Eclipse Kapua on OpenShift, connecting several IoT devices and gateways to it.

As a first step, I will setup Kapua as a standalone application using pre-built docker containers.

Then I will use a raspberry pi running Eclipse Kura to connect to Kapua and send test data.

Next steps will be the port to OpenShift making use of persistent storage and scalability. And connecting sensors to the raspberry pi gateways to send  some useful data.

Setting up Kapua if you have a running docker service is fairly easy:

You need to have a 64bit architecture, Docker version > 1.2, roughly 8 GB of free RAM and access to the internet to fetch the pre-built containers from docker hub.

docker run -td --name kapua-sql -p 8181:8181 \
    -p 3306:3306 kapua/kapua-sql:0.3.2
docker run -td --name kapua-elasticsearch \
    -p 9200:9200 -p 9300:9300 elasticsearch:5.4.0 \ \
   -Ediscovery.type=single-node \ \
   -Etransport.ping_schedule=-1 \
docker run -td --name kapua-broker --link kapua-sql:db \
    --link kapua-elasticsearch:es \
   --env commons.db.schema.update=true \
   -p 1883:1883 -p 61614:61614 kapua/kapua-broker:0.3.2
docker run -td --name kapua-console --link kapua-sql:db \
    --link kapua-broker:broker \
   --link kapua-elasticsearch:es \
   --env commons.db.schema.update=true \
   -p 8080:8080 kapua/kapua-console:0.3.2
docker run -td --name kapua-api --link kapua-sql:db \
    --link kapua-broker:broker \
   --link kapua-elasticsearch:es \
   --env commons.db.schema.update=true \
   -p 8081:8080 kapua/kapua-api:0.3.2

Each line will then fetch the container and start them.

In order to make the service accessible, I also add some firewall rules on my docker host:

firewall-cmd --add-port 8080/tcp
firewall-cmd --add-port 8081/tcp
firewall-cmd --add-port 1883/tcp

Thats all. Now you can acces the Kapua Web GUI on


Screenshot of Eclipse Kapua Web UI

The default credentials are:

Username: kapua-sys

Password: kapua-password

Additionally there is a message broker running at

Username: kapua-broker

Password: kapua-password

And a RESTful API under

Username: kapua-sys

Password: kapua-password

That really was easy. Lets see what we can do with it. Stay tuned for the next part: Installing Eclipse Kura on a Raspberry Pi.

One reply on “Creating a standalone instance of Eclipse Kapua using Docker containers”

Leave a Reply


Subscribe to our newsletter.

Please select all the ways you would like to hear from Open Sourcerers:

You can unsubscribe at any time by clicking the link in the footer of our emails. For information about our privacy practices, please visit our website.

We use Mailchimp as our newsletter platform. By clicking below to subscribe, you acknowledge that your information will be transferred to Mailchimp for processing. Learn more about Mailchimp's privacy practices here.