Upgrade Appsmith Versions

This page provides step-by-step instructions to update Appsmith to the latest version on your self-hosted instance.

Prerequisites

Before updating, ensure the following prerequisites are met:

1. At least 2 GB of free storage for backup and update tasks.
2. Update your embedded or external MongoDB server to version 5.0 or later. Refer to the compliant platforms and follow the MongoDB Replica Set Upgrade Guide.
3. Create a backup of your Appsmith instance. Follow the Backup instance guide.

Update Appsmith

Follow these steps to update Appsmith to latest version on your self-hosted instance:

Docker

These instructions are applicable to platforms using Docker, including Docker standalone, AWS AMI, and similar platforms:

Important

If your current version is older than v1.9.2. Refer to the Upgrade to Checkpoint Version (v1.9.2) guide before updating Appsmith to the latest release.

1. Locate your Appsmith installation directory by running:

   docker inspect -f '{{ (index .Mounts 0).Source }}' <APPSMITH_CONTAINER_ID>

2. Retrieve the Appsmith version you want to run.

   Find the release tag on GitHub.

3. Open docker-compose.yml in that directory and set the image for the Appsmith service to a pinned tag, for example:

   image: index.docker.io/appsmith/appsmith-ee:<version>

   If you use the Community edition image, use appsmith-ce instead of appsmith-ee and the same :<version> suffix.

4. Pull the image and restart the container. The running container matches the tag in docker-compose.yml.

   docker-compose pull && docker-compose rm -fsv appsmith && docker-compose up -d

Kubernetes

Important

If your current version is older than v1.9.2. Refer to the Upgrade to Checkpoint Version (v1.9.2) guide before updating Appsmith to the latest release.

Note: The following instructions assume you followed our Kubernetes install guide exactly. If you made changes—such as using a different Helm release name, namespace, etc.—you’ll need to adjust the commands accordingly.

1. Retrieve the latest Appsmith version

Find the latest release version on GitHub.

2. Locate your Helm values.yaml file

   • If you still have the values.yaml file from your initial installation, navigate to its directory:

     cd /path/to/your/values-file
   • If you no longer have the file, you can retrieve it from your cluster:

     helm get values appsmith-ee -n appsmith-ee | grep -v "USER-SUPPLIED" > values.yaml

3. Update the image tag in values.yaml

   • If you have yq installed:

     APPSMITH_VERSION=<version>
     yq -i ".image.tag = \"$APPSMITH_VERSION\"" values.yaml
   • If you don’t have yq, manually edit values.yaml with your preferred text editor to set the new version:

     image:
       tag: <version>

4. Apply the upgrade using Helm

Run the following command to upgrade your Appsmith installation:

helm upgrade appsmith-ee -n appsmith-ee -f values.yaml

AWS ECS on EC2

1. Log in to your AWS account and navigate to the Amazon ECS console.
2. Select the cluster containing the container instance to update.
3. Stop the task and allow the system to deploy a new task automatically.
4. Verify the updated version is running successfully.

Azure Container Instance

1. Navigate to the Azure Portal and locate the Azure Container Instance running Appsmith.
2. Restart the container by clicking the Restart button.

DigitalOcean

Important

If your current version is older than v1.9.2. Refer to the Upgrade to Checkpoint Version (v1.9.2) guide before updating Appsmith to the latest release.

1. SSH into your droplet and navigate to the Appsmith installation directory:

   cd /root/appsmith

2. Retrieve the Appsmith version you want to run.

   Find the release tag on GitHub.

3. Open docker-compose.yml and set the image for the Appsmith service to a pinned tag, for example:

   image: index.docker.io/appsmith/appsmith-ee:<version>

   If you use the Community edition image, use appsmith-ce instead of appsmith-ee and the same :<version> suffix.

4. Pull the image and restart the installation. The running container matches the tag in docker-compose.yml.

   docker-compose pull && docker-compose rm -fsv appsmith && docker-compose up -d

Troubleshooting

If you encounter errors during the update, roll back to a previous version using the Restore instance guide. If issues persist, contact support using the chat widget available on the bottom-right of this page.

See also

• Schedule automatic updates for Appsmith installation: Learn how to schedule updates to keep your installation up-to-date effortlessly.