Kendis is a cloud service, however, to provide more options for the enterprises, we also offer Kendis Enterprise Edition with Self-Hosted option. Enterprise edition has separate pricing and more details can be found at our pricing page.
Important:
After installation is successful, please remember to change the default password for the /system URL.
1) System Requirements
To be able to run Kendis smoothly at your local self-hosted environment, you should have
- Memory:
- Minimum 8 GB
- 16+ GB is recommended for smooth performance
- Storage:
- Minimum 20 GB storage for logs, database and other system level storage requirements.
- 30+ GB is recommended - CPU
- Quadcore 2.0GHz+
2) Setup Docker
In case you don't have Docker running at your local environment, you can install it from this link https://docs.docker.com/install/
There are options on the left navigation for the target OS, e.g., Linux, MAC, Windows and others.
2.1) Ensure Docker is running
Open command prompt at your local self-hosted environment, in this example, we use MAC os, and we will open "Terminal" and type command "docker"
> docker
Note: if you are using windows then you should open "command prompt" using "CMD"
3) Pull Kendis from Docker Hub
At the same command prompt the following command
> docker pull kendisdocker/kendis
It will start downloading the kendis docker. Wait for all the installation to be ready and once it is ready you will see the prompt again
4) Start Kendis Server
Start the Kendis server with the following command
> docker run --restart=always -v kendis-resources:/var/lib/kendis-resources -v kendis-logs:/var/log/kendis-logs -v kendis-backup:/var/lib/kendis-backup -v kendis-data:/var/lib/mongodb -p 8282:8080 kendisdocker/kendis
Note: Ensure that there are no line-breaks in the above command, it needs to be copied as single line at the command prompt
If all goes fine you will see the server is running at the 8282 port.
5) Access Kendis Server
To access the Kendis server please goto
<your server url>:8282/welcome
In case, you have installed at your local machine, the server URL could be your machine name or 127.0.0.1
6) Special Parameters for Run Command
- --restart=always
This will ensure the Kendis docker will be started automatically if the host machine restarts. - --add-host: <hostname>:<ip>
In case you have DNS issues from your docker container, you can use following parameters in the run command.
e.g., following 2 parameters are adding 2 host mappings
--add-host =test1.com:127.0.0.1 --add-host=test2.com:127.0.0.2 - --env aes256=true
This parameter will use a stronger key for encryption.
> docker run --add-host=test1.com:127.0.0.1 --restart=always -v kendis-resources:/var/lib/kendis-resources -v kendis-logs:/var/log/kendis-logs -v kendis-backup:/var/lib/kendis-backup -v kendis-data:/var/lib/mongodb -p 8282:8080 kendisdocker/kendis
7) Setup Guide
Once you go to Kendis welcome page, it will ask you sign-up email and password and select the prefix for your sub-domain. After these 2 simple steps, you are all set to create your first Kendis Board.
Check out this guide on creating your first Kendis Board for SAFe®
8) Data Storage
Kendis docker contains already database so you don't need to install any separate databases. Since Kendis Docker will be self-hosted by enterprises, all the data will remain within the enterprise network.
9) External Calls
Kendis Docker doesn't make any external calls outside your enterprise network, it runs completely within your enterprise network
Further Points:
- Kendis at DockerHub
Kendis is available at DockerHub for download and with few simple steps you can configure Kendis to run in your local enterprise setup.
https://hub.docker.com/u/kendisdocker
- Ensure the Shared Drives are enabled
Especially if you are installing it on Windows, ensure that shared drives are enabled. To check it, click on the Docker icon in your system try, if it's windows, you might have to right click at the docker icon and click on "Settings".
At the settings select "Shared Drives" and then select the drive you want to share.