Botpress uses SQLite by default and also provides Postgres support out of the box. In cases where you need high security, data integrity and reliability you should use Postgres. Botpress supports Postgres 9.5 or higher.

Main principle

  • SQLite: Self contained, very lightweight, file based and fully open-source RDBMS known for its portability, reliability and strong performance even in low memory environments.
  • Postgres: PostgreSQL, also known as PostgreSQL. It was created with the goal of being highly extensible and standards compliant. It is an object relational database and is capable of concurrency.

When to use SQLite and Postgres?

SQLite is highly useful for the following

  • SQLite is highly useful for the following
  • Standalone applications
  • Small apps that do not require expansion
  • Applications which need to read and write files to disk directly
  • Developing and testing

Postgres is recommended for the following

  • Data integrity and reliability is highly concerned
  • Custom Procedures which is extensible to run complex tasks
  • Complexity with ease. Postgres gives you the functionality to maintain such a complex database smoothly without limitations.

How to enable Postgres in Botpress?

Install Postgres 9.5 or higher and create a database. eg: botpressdb.

Set below 2 environment variables or create .env file with below content where bp.exe (on windows) or bp (on Linux) exists.

DATABASE=postgres DATABASE_URL=postgres://postgres:password@x.x.x.x:5432/botpressdb 

Optionally you can also set DATABASE_POOL to configure minimum and maximum DB connections via pool

 DATABASE_POOL={"min": 3, "max": 10} 

Now launch Botpress, after launch Botpress will automatically create the following 12 tables.

  • srv_metadata
  • srv_channel_users
  • workspace_users
  • workspace_invite_codes
  • srv_logs
  • dialog_sessions
  • srv_ghost_files
  • srv_ghost_index
  • srv_notifications
  • srv_kvs
  • data_retention
  • events

That’s it, Botpress is now using Postgres.

Note: Used Botpress v12.2.1


I am a Fullstack developer and Consultant with an experience of 9+ years in the industry. I mainly work on Java, React, Javascript, NodeJs, Elasticsearch and Botpress.


kenneth · February 7, 2020 at 2:01 am

what about mysql ?

    Abhishek Simon · February 7, 2020 at 4:52 am

    @kenneth Botpress only supports Postgres at the moment, but you can use every other DB in your custom actions. Let me know if you need any help here.

      kenneth kaigu · April 9, 2020 at 3:12 am

      Thank you , i would want to post all the conversations to an sql … From there, its much easier to view data if you make a dashboard .. and further manipulation with php …could you guide me how to connect to a mysql db ?

      Again, thank you so much for your tutorials… I would encourage you to make more if you make time. I speak for most when saying we are learning alot from this blog ( its bookmarked )

Jeremy · June 9, 2020 at 4:34 pm

I’m using the open source version of botpress.
I followed your tutorial (create the .env file then enter the connection to the dedicated postgresql database) but my database remind empty after launching botpress (v12.9.3)
Is it limited to the “pro” one or did I miss something ?

    Simon · June 9, 2020 at 7:47 pm

    @Jeremy No it is not limited to PRO, can you please share your.env file, the location of this file and errors if any.

How to save data from bot to Postgres DB? – Abhishek Simon · January 24, 2020 at 4:55 pm

[…] In order to save anything to Postgres DB, you need to first switch from SQLite to Postgres in Botpress. […]

Leave a Reply

Your email address will not be published. Required fields are marked *