Hosting settings

Information about Budibase hosting settings

You can run Budibase on your own infra using:

Every self-hosted Budibase platform comes by default with some settings which we recommend you familiarise yourself with as well as updating to suit your needs. All of these settings are passed to your cluster through the use of environment variables. In this section, we'll cover the purpose of each of these.

It should be noted that if you wish to modify any of these settings then you will need to restart your Budibase platform for it to recognise these new settings. If you have been running it already then changing some of these settings may affect the user experience, for example changing the JWT_SECRET will log everyone out.

The full set of variables can be found in our repo, in the file .env which should be included in your hosting solution:

VariableDescription
MAIN_PORTThe main port that your platform will run on, we have exposed this in case you need to change this.
HOSTING_KEYTo secure your app deployments we have introduced a key, which can be used to essentially password protect your Budibase platform. This means that only users with the key will be able to deploy from their builder.
JWT_SECRETA secret used to secure the JSON Web Tokens (JWT) generated by the platform for user authentication. We recommend changing this to a UUID.
MINIO_ACCESS_KEYThe platform makes use of the open-source S3 alternative Minio for object storage, this specifies the access key used to secure the cluster.
We recommend changing this.
MINIO_SECRET_KEYThis is another component used to secure Minio.
We recommend changing this.
COUCH_DB_USERThe username used to secure your hosted CouchDB service.
We recommend changing this.
COUCH_DB_PASSWORDThe password used to secure your hosted CouchDB service.
We recommend changing this.
WORKER_API_KEYA key used to secure one of the internal services of our platform.
We recommend changing this to a UUID.
SQL_MAX_ROWSBy default the maximum number of rows returned by a SQL query is 5000, but you can use this variable to change that.

Other settings in the file do not need to be changed but are simply provided in case you which to change the port a service is made available on, we provide access to all the various services our cluster uses directly on a port number for administration purposes (e.g. logging into Fauxton on CouchDB).


What’s Next