> For the complete documentation index, see [llms.txt](https://dev.solid-run.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.solid-run.com/solidsense/solidsense-software/kapua/installing-a-dedicated-kapua-instance.md).

# Installing a dedicated Kapua instance

{% hint style="warning" %}
The documentation for SolidSense software is not maintained by SolidRun and the information herein is not actual with the latest version of the software, please contact our partner [SolidSense Connect](https://solidsense-connect.com/) who is now developing the SolidSense software.
{% endhint %}

The SolidSense Kapua instance is not meant for production purpose, so we recommend the deployment of a dedicated instance when Kapua is to be used in production, in particular if data have to be stored in the Kapua database.

### Installation procedure

Prerequisite for Kapua installation are the following

* 64 bit Linux system with minimum 6GB of RAM, we recommend 8GB, dual core system
* Java VM Version 8
* Docker 1.2+

The system needs to be connected to the internet during installation.

Here are the instructions:

```
$ git clone git@github.com:eclipse/kapua.git kapua
$ cd kapua/deployment/docker
$ ./docker-deploy
```

After you can connect to the console by

http\://:8080

Default credentials

User: kapua-sys

Password: kapua-password

{% hint style="warning" %}
**Please Note** We strongly recommend to change the the password as soon as possible.
{% endhint %}

### Changing Kapua sysadmin password

1. Log on Kapua as kapua-sys, go on the users screen and change the password using the credential tab. Remember that the password needs to be at least 12 characters long
2. Goto to the kapua/deployment/docker directory from installation
3. Edit (vi or nano as you like) the compose/docker-compose.yml
4. In each “environment” section of the file add the following line: -‘transport.credential.password=’
5. Note that the quote are mandatory
6. Then redeploy Kapua: bash docker-deploy.sh


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.solid-run.com/solidsense/solidsense-software/kapua/installing-a-dedicated-kapua-instance.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.