Running an app in safe mode

STANDARD PREMIUM ULTIMATE

Safe mode lets an app boot while keeping its flows stopped. This can help prevent repeated crash loops caused by flow execution, giving you time to inspect and adjust the flows before they run again.

Before you begin

Ensure you have the necessary roles and permissions to upgrade apps in your space and access to the YAML view for deployments.

Enable safe mode

To enable safe mode:

Navigate to the app that should be started in safe mode.
Start an app upgrade, as explained in Upgrading an App Deployment.
In the upgrade dialog, in the “Infrastructure” section, switch to YAML view.
Set the following value before completing the dialog:
CODE
```
enableSafeMode: true
```
Review the deployment settings and complete the upgrade.

The change will typically appear within a minute.

After the app starts in safe mode, its flows remain stopped by default.

Safe mode message in the Flow Editor

When you open the Flow Editor for an app that is running in safe mode, the following message is displayed at the top:

Flows stopped in safe mode. Modify your flows and deploy changes to restart.

Modify the flows as needed, then deploy your changes to restart them.

Flows can be manually stopped, started, and restarted at any time by using the menu next to the Save button in the Flow Editor. This is possible regardless of whether safe mode is enabled. To learn more, see Starting, stopping, and restarting flows