Update Appsmith

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

Prerequisites

• At least 2 GB of free storage space for backup and update tasks.

Before you begin

• Create a backup of the Appsmith instance, See Backup instance guide. (Recommended)
• Upgrade your embedded or external MongoDB server to MongoDB v5 or later. See the list of compliant platforms and follow the steps to Upgrade a Replica Set to 5.0.

Update on Docker

Before you begin the Appsmith update, ensure you have met all the prerequisites, and your current Appsmith version is v1.9.2 or later. If you're not on this version, see the Upgrade to checkpoint version guide.

Follow these steps to update Appsmith, these instructions can be used to update Appsmith on any platform that supports Docker (Docker, AWS AMI, or DigitalOcean).

1. Go to the Appsmith installation directory. If you don't know the directory, find it with:

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

2. Update the Appsmith installation to the latest version with:

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

   The above command pulls the latest image of Appsmith and updates the installation after restarting the Docker container.

You may choose to schedule automatic updates for your Appsmith Docker installation. For more information, see Schedule Automatic Updates for Docker installation.

Update on Kubernetes

Before you begin the update, ensure you have met all the prerequisites. Follow these steps to update Appsmith:

• If you are on the Community Edition, update the installation to the latest release with:

  kubectl rollout restart statefulset appsmith

• If you are on the Business Edition, update the Appsmith container image to the latest release with:

  kubectl rollout restart deployment appsmith

  You may choose to schedule automatic updates for your Appsmith Kubernetes installation. For more information, see Schedule Automatic Updates for Kubernetes installation.

Update on AWS ECS EC2

Before you begin the update, ensure you have met all the prerequisites. Follow the below steps using the Classic Amazon Web Console to update Appsmith:

1. Log in to your AWS account.
2. Go to the Amazon ECS console.
3. Choose the cluster that has the container instance you wish to update.
4. Click the Tasks tab.
5. Select and click the task you wish to update.
6. Click the Stop button to stop the task. Wait for the automatic deployment of a new task to be completed.
7. Verify that the updated version of your application is running as expected.

Troubleshooting

If you see errors, roll back to a previous version to fix the issue. For more information, see the Restore instance section.

If you continue to face issues, contact the support team using the chat widget at the bottom right of this page.