Summary

This section describes how to install Kaholo Server using Docker

Pre-Requisite

Before you install your Kaholo server make sure you have:

  • Docker installed
  • MongoDB >= 4.0 with replication
    Install instructions can be found in this link:

https://docs.mongodb.com/manual/installation/

*** Make sure that in the mongo conf file you can listen correct IP address (usually located at /etc/mongod.conf)

Download and Install the server from Docker Hub

Before downloading the Docker Image, you need to create a .env file locally with the following content:

UPLOAD_PATH=uploads
INTERVAL_TIME=5000
RETRIES=3
PAGE_SIZE=15
PORT=3000
NODE_ENV=production
LICENSE_PUBLIC_KEY=-----BEGIN PUBLIC KEY-----\nMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA08Z9nFeLlVqmO3TNlj+V\nAHQDg7Ab5BJH2H1VU640k54CgoIf4+VOw+sbR5EWhKRKY7R0v6KPy4KLtzqOQA+d\n40ku3SZzzAZzFYEWczyuDZNioME31yFC+LQvNAOVwCa+fiA+Nko7U074VYxWrqzU\n4m9hr84X8xF03eW6/Q8fRX8JdJGpSHeVMTKT2K6qKKwjjZ7pJMzy+7yZe4mDBhbL\nZ+daIrwuyOQIWacAghJlj93R46zwM3JvBqLRsoAmj49FCnpj9XaOb5/2u1eMSjWN\nJzancchekhFGMasNm/Ljmi+p7GVmYBDkf2Rd82sSGoya9OldX9FaZ2ySuoimOzhQ\nNpiC7FbePvXEJuf7ELAryThULbyWNTwnUzU9c5CC+IidsBv3s4PMIiwJfQZkk8Ml\n5ilQnxdr47jBgFmWlajyS78kwgKpUTjRDysRwgt7xWYBYBHXnznFaP5eHdXQLQXv\n7cciAa18OgSa1vBu4VG9GKvXwak4Cb7mbXD7reRdcRecA/Nvo087GYP43pvbNHjy\n+rRbg8naYmnylOZ9JrwutaheTAza8LH8eN8x2YewIXUxuqepwZR8e939ksZFq4On\n/eMrN7DOpTRpioi6sHxkF3W0/UpJM1XQw/jmwaaEMKgW+2KI4UCl6GamSZI4NG/u\nCVraYa7y731pXezAtuHuGTECAwEAAQ==\n-----END PUBLIC KEY-----
DB_URI=
SERVER_KEY=
SEQ_QUEUE_RETRY_DELAY=1000
SEQ_QUEUE_RETRY_ATTEMPTS=3
FORCE_HTTPS=false

In the .env file:

  • Set DB_URI – mongoldb connection string (you should use the IP address and not localhost)
  • Set SERVER_KEY – random string of 32 alpha-numeric characters

You can also change the following parameters:

  • SEQ_QUEUE_RETRY_DELAY=1000   // Delay between queue retries
  • SEQ_QUEUE_RETRY_ATTEMPTS=3 // Queue retries attempts
  • FORCE_HTTPS=false                            // Either to force browsing to Kaholo using HTTPS only or not

 

*** Before running the commands:

  1. Make sure you configure in the run command the path to the .env file.
  2. Make sure you have the following folder tree:
    1. .kaholo
    2. .kaholo/uploads
    3. .kaholo/plugins
docker pull kaholoio/kaholo
docker run --restart unless-stopped -v ~/.kaholo/uploads:/static_cdn/uploads -v ~/.kaholo/plugins:/app/libs/plugins --env-file <path-to-env> -d -p 3000:3000 kaholoio/kaholo:latest

 

Close Menu