Deploying a cluster on Digital Ocean

Prerequisite

• Create a domain name dedicated to your Botpress Cluster, and generate a certificate. If you don't have a certificate, you can follow these instructions to generate one quickly using Let's Encrypt.

Instructions

1. Create a new Load Balancer

   • Forwarding Rules: HTTPS 443 -> HTTP 3000 (define the certificate created earlier). It is also possible to use Passthrough if you setup NGINX to redirect HTTPS requests
   • Health Checks: You might want to set those numbers lower
   • Sticky Sessions: Enabled

2. Create a droplet (Ubuntu 18.04) for your Redis instance

   • Update the bind settings so your BP nodes can reach it
   • Secure it with a strong password

3. Create a droplet (Ubuntu 18.04) for your Postgres instance

   • Define a password for your postgres user
   • Make it accessible by each BP nodes
   • Create a new database

4. Create a droplet (Ubuntu Docker 18.06) for each BP node you want to use. We will use the first one to configure the database and licensing of our cluster.

5. Create a server.yml file and upload it on the first droplet. This file identifies which Docker image we will use and sets the required environment variables.

version: '3.5'

services:
  botpress:
    image: botpress/server:$TAG
    environment:
      - PRO_ENABLED=true
      - CLUSTER_ENABLED=true
      - BP_LICENSE_KEY=<license_key>
      - EXTERNAL_URL=https://yourbot.yourhostname.com
      - DATABASE_URL=postgres://user:pass@host/dbName
      - REDIS_URL=redis://host:port
    command: './bp'
    ports:
      - '3000:3000'

6. Upload the file server.yml file on each nodes created in step 4

7. Run the command docker-compose -f server.yml up -d on each node, and your Botpress Cluster is ready !