Skip to main content

Deployment Errors

Ports unavailable

If you encounter the error that ports 80 & 443 aren't open, its is recommended that you stop all processes on these ports and start again. If the processes on these ports cannot be stopped, you can run appsmith on another port.

  1. In the file docker-compose.yml, change the ports for the Nginx container to a custom port as shown in the below example.

    - "80:80"
    - "443:443"
    - "9001:9001"

    Change to

    - "8080:80"
    - "8443:443"
    - "9801:9001"
  2. Run docker-compose up -d


To stop a previous version of appsmith running on these ports, run the following:

  • sudo su
  • docker container kill $(docker ps -q)

Containers Failed to Start

If you chose to initialize a new database and are seeing this error, it could be due to an error while fetching dependencies during installation. Deleting the current installation direction, killing the docker containers, and restarting the installation should work. If it doesn't, please reach out on discord

If you are trying to connect to an existing MongoDB and the containers failed to start it may be due to one of the following reasons:

  1. Incorrect MongoDB credentials
  2. Empty Salt / Password for encryption

Restart the installation process with valid values.

Unable to access Appsmith

  • Ensure your security groups are configured to allow traffic to ports 80 & 443 on your installation instance.
  • You can access the running application on localhost in any browser or the public IP of your machine.
  • You may need to wait for a few minutes before accessing the application to allow Nginx to start.

OAuth sign up not working

If your deployment is behind an ELB / Proxy, you must update the Nginx configuration of the deployment. In the file data/nginx/ modify the line:

proxy_set_header X-Forwarded-Proto $scheme;


proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto;

This ensures that the redirect URLs are correct during OAuth2 logins. This works even if the ELB is configured to run on a custom port.

Server not booting because of MongoCommandException

In release v1.6.4, Appsmith upgraded its libraries & Spring framework. This caused a compatibility issue between the libraries used within Appsmith and the version of MongoDB that was shipped earlier. This didn't show up in testing because all testing happened against MongoDB clusters with replica sets, where the problem doesn't surface.

If you see an error like the below, your instance is affected by the library upgrade performed in v1.6.4.

Caused by: com.mongodb.MongoCommandException: Command failed with error 17 (ProtocolError): 'Attempt to switch database target during SASL authentication.' on server mongo:27017. The full response is {"ok": 0.0, "errmsg": "Attempt to switch database target during SASL authentication.", "code": 17, "codeName": "ProtocolError"}

Please follow the steps mentioned below to fix your Appsmith installation.

Step 1: Edit MongoDB URI

Adding &authSource=admin to the end of your APPSMITH_MONGODB_URI variable’s value in your docker.env file. For example, in your docker.env file, if you have the following line:

# Old config

Change it to the following (notice the only change is &authSource=admin. Please don't paste this whole line. Only add the &authSource=admin part to your current value.

# New config

Save the file.

Step 2: Restart server

Now restart your container with the following command:

sudo docker-compose up -d --force-recreate appsmith-internal-server

In a minute or two, the server should now come up and be ready.

Unable to send emails

If you are having trouble with invitation emails not being sent, even though the Admin email setup is able to send test emails, it may be due to an issue with the configuration of the email parameters.

If you aren't receiving the invitation email, please check the value for APPSMITH_REPLY_TO in the configuration file. If this value is empty, please set it to the same email address that you are using for APPSMITH_MAIL_FROM and restart the application.

This should resolve the issue of not receiving the invitation email. Additionally, it may be helpful to verify that the email server being used is working correctly and there are no issues with the network or other components preventing the emails from being sent.

However, if you encounter any issues, you can contact the support team on Discord or ask questions on the community forum.

Server shuts down with schema mismatch error

The instance keeps restarting due to a server shutdown displaying a schema mismatch error.

Error message

Looks like you skipped some required updates, please go back to the mandatory upgrade path v1.9.2


As the error message in the server logs suggests, your Appsmith instance has missed a required checkpoint upgrade. This occurs if you are manually upgrading and have skipped a version or are on an automatic upgrade but your instance hasn't checked for updates for a particular period.


To resolve this error, you must upgrade to the checkpoint version, in this case, v1.9.2.

To prevent similar issues in the future, consider enabling auto updates for your Appsmith instance. If you already had auto updates on and still encountered this issue, please contact the Appsmith team to determine the cause of the deployment problem

Illegal instruction (core dumped)

MongoDB fails to start, after migrating to MongoDB version 5.

Error message

Illegal instruction (core dumped) mongod –fork –port 27017 –dbpath “$MONGO_DB_PATH


MongoDB version 5 has specific CPU requirements. If these requirements are not met the server wouldn't start.


To resolve this error, you must upgrade your infrastructure. See the List of complaint hardware.

If it is not possible for you to upgrade your infrastructure to support MongoDB version 5 or higher:

  • You may use an external MongoDB version 5 or higher on MongoDB Atlas.
  • If you are upgrading your infrastructure and need time, consider downgrading Appsmith. Once you have upgraded MongoDB, Update Appsmith to the latest version to use new features.

Follow the steps below to downgrade to v1.8.15:

  1. Access your Appsmith instance and make the below change to the docker-compose.yml file:

    container_name: appsmith
  1. Run the restart command:

    docker-compose up -d

    Your server starts with version 1.8.15, which makes all the necessary schema changes to your Appsmith instance.