Skip to main content

Monitor Subsystems

Appsmith uses Supervisor to manage and monitor key subsystems, including the Appsmith server, Caddy, and MongoDB. If a subsystem becomes unresponsive, Supervisor attempts to restart it automatically. If the Health Check API fails, you can use Supervisor to diagnose and manage subsystems.

You can monitor and manage processes using either the Web Interface or the Command Line Interface (CLI).

The Supervisor Web Interface provides an easy-to-use, graphical way to monitor and manage Appsmith processes. Follow the steps below to configure and access the web interface.

  1. Go to the docker.env file located in the stacks/configuration folder.
  2. Add the following environment variables to set the Supervisor credentials:
APPSMITH_SUPERVISOR_USER=<SUPERVISOR-USER>
APPSMITH_SUPERVISOR_PASSWORD=<SUPERVISOR-PASSWORD>

If these variables are not set, you must create a new Supervisor user by manually defining a username and password in the docker.env file. Supervisor uses these credentials for authentication when accessing the web interface.

  1. Save the file and restart your Appsmith instance for the changes to take effect.

  2. You can access the Supervisor web interface at http://[your-domain]/supervisor. For example, if your Appsmith instance is available at http://localhost, the Supervisor web interface can be accessed at http://localhost/supervisor.

    All managed processes listed in the web interface
    All managed processes listed in the web interface

Troubleshooting

If resource usage exceeds defined thresholds or you face deployment issues, capture relevant monitoring screenshots. Refer to the troubleshooting guide for common errors. If the issue persists, contact Appsmith Support using the chat widget at the bottom right and provide the screenshots for further diagnostics.