Work in progress

We're working on a better deployment guide

Services and Docker images

Running botfront requires deploying different services. The recommended way is to use an orchestration framework such as Kubernetes or Swarm.

Service Docker image
botftont botfront/botfront
botfront-api botfront/botfront-api
nlu botfront/rasa-nlu-bf
core botfront/rasa-core-bf
actions Build your own or botfront/simple-actions for simple FAQs
mongo mongo or hosted service (mLab, Mongo Atlas, Compose, ...)

See the docker-compose.yaml file in your botfront-project for an example

Required environment variables

Environment variable Description Required by
ROOT_URL The Botfront app URL (e.g. https://botfront.your.domain) botfront
MONGO_URL The mongoDB connection string (e.g. mongodb://user:pass@server:port/database) botfront botfront-api
MONGO_OPLOG_URL The mongoDB Oplog connection string botfront
MAIL_URL An SMTP url if you want to use the password reset feature botfront
BF_PROJECT_ID The Botfront project ID (typically my-first-project) core
BF_URL The botfront-api root url core actions

MongoDB database

When you run Botfront in developer mode, Meteor will spin up a local MongoDB database accessible on port 3001. However, when running in production or with docker-compose a MongoDB uri needs to be provided with the environment variable MONGO_URL. It is also highly recommended (but optional) to provide an oplog url with MONGO_OPLOG_URL.

Choose a very short database name

We strongly recommend using a very short database name (e.g bf) and not too long response names to avoid hitting the limits.

Technical requirements

Those are the miminal requirements:

Service RAM CPU
botfront 1 Gb 1
botfront-api 512 Mb 0.5
duckling 512 Mb 0.5
rasa-nlu (supervised_embeddings) 1 Gb 1
rasa-core 512 Mb 1
Last Updated: 5/30/2019, 3:32:40 PM