Skip to main content

Infra Level Rollback

Infra level rollback allows you to revert your ToolJet deployment to a previous version at the infrastructure level. This is not recommended for general use and should only be considered when the current version has breaking changes or bugs that block usage.

Consult ToolJet Team First

Infra level rollback should only be used as a last resort, after consulting with the ToolJet team.

Rollback Steps​

Step 1: Take a Snapshot of Your Database Instance​

Before starting the upgrade, take a snapshot of your database instance so that it can be restored if a rollback is needed later. Also note down the version you are upgrading from, so you know exactly which version to roll back to if needed.

info

If your database is deployed as a container alongside ToolJet rather than as an external database, the snapshot and restore process will look different. Reach out to your infrastructure team for help with this.

  1. Navigate to RDS Console → Databases
  2. Select your database instance
  3. Click Actions → Take snapshot RDS Actions menu with Take snapshot option
  4. Enter a snapshot name, for example: pre-upgrade-snapshot-YYYYMMDD
  5. Click Take snapshot RDS snapshot successfully created

If PG_DB and TOOLJET_DB are hosted on separate instances, repeat this for each instance.

Step 2: Roll Back the ToolJet Deployment​

  1. Open your docker-compose.yaml file and update the image tag for the tooljet (and tooljet-worker-1, if present) service to the previous version, for example: 
    image: tooljet/tooljet:v3.20.200-lts
    docker-compose.yaml with the image tag updated to a previous version
  2. Pull the older image: 
    docker-compose pull
  3. Restart the deployment on the older version: 
    docker-compose up -d

Step 3: Restore the Database from the Snapshot​

  1. Navigate to RDS Console → Snapshots
  2. Select the pre-upgrade snapshot
  3. Click Actions → Restore snapshot
  4. Configure the new instance settings and click Restore DB instance
  5. Once available, point your ToolJet deployment's database configuration to the restored instance

Need Help?​