Installation

Installing Kondukto is very trivial, and in most cases, it doesn't require any additional steps or configurations.

To install Kondukto, please follow the step-by-step instructions:

Create the directory and navigate to it:

mkdir Kondukto && cd Kondukto

Extract the archive:

unzip kondukto.zip

Give execution permission to the installer.run file:

chmod +x installer.run

Download & Install the required 3rd parties:

  • Git
  • Nginx
  • Docker
  • Docker-Compose

Run the Kondukto installer:

./installer.run

Once the installer starts to run, it will ask you for fundamental configuration choices:

❗️

Even if you want to install it as Host, choose Docker installation. It would be better to set the Host manually if it needs it.

Do you want to proceed? (Y or N)

Please choose a database system: docker for PoC, host for production installation

Please enter hostname or IP address : https://(ip address or hostname of the server)

Please enter your registration key: {your_registration_key}

Kondukto has a service for systemd, do you want to load and enable the service? (Y or N)

Do you want to load Kondukto default Nginx configuration? (Y or N)

After these steps, it will ask you for some information to create a self-signed TLS certificate. If you want to use your organization's TLS certificate, you can skip the questions by clicking to enter.

Country Name (2 letter code) [AU]:
State or Province Name (full name) [Some-State]:
Locality Name (eg, city) []:
Organization Name (eg, company) [Internet Widgits Pty Ltd]:
Organizational Unit Name (eg, section) []:
Common Name (e.g. server FQDN or YOUR name) []:
Email Address []:

Make sure Kondukto is not active after the installation is finished

systemctl status kondukto

If Kondukto is in an Active state, stop it.

systemctl stop kondukto

Go to the Kondukto folder.

cd /opt/.kondukto/bin

Re-license Kondukto.

❗️

Licensing is required after installation by the installer.

./kondukto -r {your_registration_key}

Go to the Kondukto Config folder.

cd /etc/kondukto

Back up the Docker-Compose file and download the latest Docker-Compose configuration.

mv docker-compose.yml docker-compose.yml.bak
wget https://download.kondukto.io/docker-compose.yaml

Back up Config.yaml file

cp config.yaml config.yaml.bak

Create the Nats-Config file.

nano nats-config

Type "max_payload: 10000000" and exit after saving.

👍

You can exit by doing CTRL+X.

Edit /etc/hosts file. Add the following lines:

  • 127.0.0.1 mongodb
  • 127.0.0.1 kondukto-nats
  • 127.0.0.1 kondukto-redis
When editing is finished, etc/host's entry should be as in the picture.

When editing is finished, etc/host's entry should be as in the picture.

If you wish to change Kondukto's hostname after the installation step, please visit the config.yaml file and change the "host" line.

# Kondukto Configuration
host: https://your_kondukto_hostname

If you want to use the database on the Host instead of Docker, you can configure it in config.yaml.

❗️

If you are going to use MongoDB as docker, change the db host from localhost to mongodb.

db:
  mode: host # available values are docker, host
  host: {MongoDB_Hostname}
  port: 27017
  # Leave empty if database does not have credentials
  username: {MongoDB_Username}
  password: {MongoDB_Password}

Create the Redis folder and navigate into it.

mkdir /etc/redis && cd /etc/redis

Download Redis tools. Grant execute authorization and run.

wget https://download.kondukto.io/infra/redis/redis.conf
wget https://download.kondukto.io/infra/redis/redis-tune.sh
chmod +x redis-tune.sh
./redis-tune.sh

❗️

If you get an error running redis-tune.sh. You can edit it with nano and delete the "sudo apt install redis-tools" line.

Create the Nats folder and navigate into it.

mkdir /etc/nats && cd /etc/redis

Download the Nats CLI and Run.

For Debian distributions:

wget https://github.com/nats-io/natscli/releases/download/v0.0.35/nats-0.0.35-amd64.deb
sudo dpkg -i nats-0.0.35-amd64.deb

For RedHat distributions:

wget https://github.com/nats-io/natscli/releases/download/v0.0.35/nats-0.0.35-amd64.rpm
yum localinstall nats-0.0.35-amd64.rpm

Go to the Kondukto Config folder. Update Docker Containers. Start the Kondukto system.

cd /etc/kondukto
docker-compose down && docker-compose pull && docker-compose up -d
systemctl start kondukto