ToolJet/docs/versioned_docs/version-2.19.0/setup/digitalocean.md

id	title
digitalocean	DigitalOcean

Deploying ToolJet on DigitalOcean

Now you can quickly deploy ToolJet using the Deploy to DigitalOcean button.

If you have any questions feel free to join our Slack Community or send us an email at hello@tooljet.com.

The latest docker image is tooljet/tooljet:<version_tag>

Deploying

Follow the steps below to deploy ToolJet on DigitalOcean:

1. Once signed-in to your DigitalOcean account, click on the Create App button.

2. On the next page, you'll be asked to choose a Resource type, select Docker Hub. Enter the Repository name as tooljet/tooljet and the corresponding tag.

3. Once the Resource is created, you'll be redirected to the Resources page. Click on the Edit button next to the Resource.

Make sure the Run Command is ./server/scripts/digitalocean-postbuild.sh and the HTTP port is 3000. Once you have edited the ToolJet resource click on the Back button.

Redis setup

ToolJet requires configuring Redis which is used for enabling multiplayer editing and for background jobs.

Follow the steps below to configure Redis database:

1. Navigate to Database and create a database cluster.

2. Select Redis from the database engine and add a unique name to the cluster and click on Create Database cluster.

3. Once the set-up is complete, add the Redis connection string in the environmental variable of tooliet-app. :::info In the business edition, saving or making changes in apps is dependent on Redis, even if multi-player editing is not necessary. :::

Database setup

Follow the below steps to attach a postgresql database:

1. Click on Add Resource and select Database and click on add.

2. Enter the preffered name for the database and click Create and attach.

Setting up environment variables

1. Once the database is attached, click on Next to set up the environment variables.

2. Click on Edit next to tooljet-app.

3. Click on the build editor to edit the environment variables.

NODE_ ENV=production
NODE_OPTIONS=--max-old-space-size=4096
LOCKBOX MASTER_KEY= #Use `openssl rand -hex 32`
SECRET KEY BASE= #Use `openssl rand -hex 64`
DEPLOYMENT_PLATFORM=digitalocean
DATABASE_URL=${<enter the db name which was attached>.DATABASE_URL}
CA CERT=${<enter the db name which was attached>.CA_CERT}
TOOLJET HOST=${APP_URL} 
TOOLJET_SERVER_URL=${APP_URL} 
REDIS_URL= #connection string

DATABASE_URL and CA_CERT variable should be added in the above format.

4. After adding the environment variables, click on Save.

To add additional environment variables, refer this doc.

Deploying Tooljet Database

If you intend to use this feature, you'd have to set up and deploy PostgREST server which helps querying ToolJet Database. You can learn more about this feature here.

Follow the steps below to deploy ToolJet Database on DigitalOcean:

1. If you are using dev database within ToolJet deployment, upgrade it to managed database. You could also add a separate database, if you intent use a different database, please refer the environment variables for additional env variables.

2. Create a new app for PostgREST server. You can opt for docker hub to deploy PostgREST image of version 10.1.x.

3. Update the environment variables for PostgREST and expose the HTTP port 3000.

4. Add your newly created PostgREST app to the trusted sources of your managed or separate database.

5. Update your existing ToolJet application deployment with environment variables required for PostgREST.