--- title: "Enable Safe Mode" slug: "safe-mode" updated: 2025-04-10T20:46:54Z published: 2025-04-10T20:46:54Z canonical: "docs.redcanary.com/safe-mode" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.redcanary.com/llms.txt > Use this file to discover all available pages before exploring further. # Enable Safe Mode ## What is Safe Mode? Safe Mode instructs the agent to stop collecting endpoint telemetry due to incompatibilities or risks identified. This unique feature gives you both proactive and reactive capabilities to ensure the agent is running safely and performantly on your endpoints. ## Safe Mode conditions An agent will go into Safe Mode when one of the following conditions occurs: 1. The agent has identified incompatibilities with the endpoint > [!TIP] > **Example**: The agent was installed on an unsupported Operating System (distribution or version) 2. The agent is remotely configured to go into Safe Mode. See [below](/doc/docs/safe-mode#explicitly-enabling-safemode-for-an-endpoint) for more details. To do this, the sensor restarts, ensuring that all memory usage is reset, and enters and remains in Safe Mode until the sensor's periodic checks of its remote config indicate that no more unsafe conditions exist. The sensor will exit safe mode once it has ensured safe operating parameters. ## Determining if Safe Mode is enabled for an endpoint 1. From the navigation menu click on **Endpoints**. 2. Find the endpoint in question and load the endpoint page. 3. Take note of the status of the Safe Mode button in the upper right corner of the page. ![Safe_Mode.png](https://cdn.document360.io/75147bee-bf0d-444c-8afb-6e83b11ec0ef/Images/Documentation/11099409166743.png?sv=2026-02-06&spr=https&st=2026-11-19T07%3A14%3A12Z&se=2026-11-19T08%3A14%3A12Z&sr=b&sp=r&sig=bNDf5Cgh9AU8N8REqYdMmOGIY125ary%2BUsrDB8VHobo%3D) > [!NOTE] > **Note**: Hovering over the button will display the reason the endpoint is in safe-mode. ## Explicitly enabling Safe Mode for an endpoint You can explicitly enable Safe Mode for any endpoints in your environment. 1. From the navigation menu click on **Endpoints**. 2. Find the endpoint in question and load the endpoint page. 3. Click **Enable Safe Mode** button. ## Explicitly enabling Safe Mode for all endpoints 1. From the navigation menu click on **Endpoints**. 2. In the table, click **Disable Telemetry Collection**. ![Disable_telemetry.png](https://cdn.document360.io/75147bee-bf0d-444c-8afb-6e83b11ec0ef/Images/Documentation/11099592067991.png?sv=2026-02-06&spr=https&st=2026-11-19T07%3A14%3A12Z&se=2026-11-19T08%3A14%3A12Z&sr=b&sp=r&sig=Zzj9kv92ihyvxkHFeA9PlT5VDPHA%2FzLWf5Zg1YHSISo%3D) ## Enabling and disabling Safe Mode via the command line To manually enable Safe Mode through the command line, you can run: > ```plaintext > /opt/redcanary/cfctl safe --enable > ``` To disable Safe Mode and return the agent to normal operation through the command line, run: > ```plaintext > /opt/redcanary/cfctl safe --disable > ``` ## Configuring logging The maximum size of logs spooled and the location of the log directory can be adjusted by modifying the agent's configuration file. Log spooling uses a dedicated location for storing logs if telemetry is not able to be offloaded quickly enough. In most cases the spooling directory will be empty. Be aware that the logs in the spooling directory should not be confused with agent log files which are in CSV format. #### Configuration file ```plaintext /opt/redcanary/config.json ``` ## Maximum size of log directory Add the following key-value pair to the configuration file, replacing `` with the new directory size. > **Note**: 1024 MB is the default. ```plaintext "max_log_directory_size_mbytes":"" ``` ## Location of log directory The following directory is the default location for spooled logs. ```plaintext /opt/redcanary/spool ``` This can be modified by adding the below key-value pair to the configuration file, replacing `` with the new directory path. > **Note**: The path set is relative to `/opt/redcanary/`. ```plaintext "spool_directory_name":"" ```