> For the complete documentation index, see [llms.txt](https://doc.flow.swiss/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.flow.swiss/products/ci-engine/how-to/enable-debug-mode.md).

# Enable Debug Mode

### Debug Mode

Runners can be started in debug mode, in which case we will keep them running for 12 hours. During this time you can connect to the runner via SSH or VNC.

#### Integration Debug Mode

Debug mode can be enabled for a whole integration. Then every runner of that integration will be started in debug mode. To enable debug mode for the whole integration:

1. Navigate to the details page of your integration.
2. Click on **(**•••**)** **More** and **Change Settings**.
3. Toggle the **Debug mode** setting.

To disable debug mode simply follow the steps above again and toggle the **Debug mode** setting off.

#### Runner Debug Mode

Debug mode can be enabled for a single runner. To enable debug mode for a runner:

1. Navigate to the details page of your subscription.
2. Select the tab of **Active Runners**.
3. Click on the **(**•••**)** **More** of the runner you would like to debug and then on **Enable Debug Mode**.

To disable debug mode simply click on **(**•••**)** **More** of the runner currently in debug mode and then **Disable Debug Mode**.

### Connect to Runner

To connect to the runner via VNC or SSH follow these steps in the wizard:

1. Navigate to the details page of your subscription.
2. Open the **Active Runners** tab.
3. On the runner you wish to connect to, click on **(**•••**)** **More**.
4. Click either on **Connect with VNC** or **Connect with SSH**.
5. Open Cloudflare Tunnel
   1. Either run the cloudflare daemon in docker or locally by copying the command displayed in the wizard.
6. Connecting via VNC
   1. Connect to your runner with your preferred VNC application using the address and credentials provided in the wizard.
7. Alternatively to step 6: Connecting via SSH
   1. Download the SSH private key to authenticate yourself with the runner. Copy the SSH command from the wizard and adjust the path to your private key file that you saved before.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.flow.swiss/products/ci-engine/how-to/enable-debug-mode.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.