Skip to main content

Overview

When using Appsmith, you may encounter errors related to both self-hosting the platform and building applications. This page provides detailed resources to help you troubleshoot and resolve common issues. Whether you're facing deployment issues, database connection problems, or application-specific errors, you can find the relevant troubleshooting guides below for step-by-step solutions.

To troubleshoot your issue, you can try the following:

Check Your Appsmith Version

Knowing your version is crucial for debugging and ensuring compatibility with the latest features and fixes.

  • For Docker: Run the following command in your terminal:
docker exec -it appsmith cat info.json
  • For Kubernetes: Run the following command to check the version:
kubectl exec -it <appsmith-pod-name> -- cat /appsmith-stacks/configuration/info.json

After confirming your Appsmith version, visit the Appsmith GitHub Release Notes to compare your version with the latest release. If your version is outdated, consider upgrading to resolve known issues and benefit from new features.

See the upgrade guides for instructions on how to upgrade.

Verify Logs for Errors

After checking your version, verify the logs to identify any errors or issues with your deployment. Logs provide critical information regarding Appsmith's health and any errors that might be affecting the platform.

  • For Docker: You can view logs using the following command:
docker logs appsmith
  • For Kubernetes: Use the following command to view logs for the Appsmith pod:
kubectl logs <appsmith-pod-name>

Restart Services

To resolve potential issues related to resource allocation or configuration changes, restart the Appsmith services. This can help in clearing temporary issues and ensuring smooth operation.

  • For Docker:
docker restart appsmith
  • For Kubernetes:
kubectl rollout restart deployment appsmith

If the steps above don’t resolve your issue, refer to more specific troubleshooting guides:

Contacting Support

If you are unable to resolve your issue using the provided troubleshooting guides, you can contact Appsmith support for assistance. To get in touch with the support team, use the chat widget on the page for further help.