> ## Documentation Index
> Fetch the complete documentation index at: https://trunk-4cab4936-automation-firewatch-docs-sync.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Instrucions to setup and configure the Direct-to-Queue capability of the Merge Queue.

#### Prerequisites

* Admin access to your GitHub organization
* Installed the core Trunk app and Trunk Sudo app on the target repo
* Configured branch protection using Rulesets (classic branch protection will not work for direct-to-queue)

#### Configure rule sets for Trunk Sudo

Your branch protection configuration must allow Trunk Sudo to bypass the relevant rules when it merges your original pull request.

#### GitHub Rulesets

In GitHub, navigate to **Settings** → **Rules** → **Rulesets**. For every active ruleset that applies to your merge branch:

1. Open the ruleset.
2. Under **Bypass list**, add the **Trunk Sudo** GitHub App.
3. Set its bypass mode to **Exempt**.
4. Save.

<Frame caption="Trunk Sudo's bypass mode must be Exempt.">
  <img src="https://mintcdn.com/trunk-4cab4936-automation-firewatch-docs-sync/bF34xrB5NUZaMQBn/assets/setup-and-administration/trunk-sudo-ruleset-bypass-mode.png?fit=max&auto=format&n=bF34xrB5NUZaMQBn&q=85&s=cef40e00836ee532e30d68adb4335e23" alt="GitHub ruleset bypass list with Trunk Sudo set to Exempt" width="1608" height="1750" data-path="assets/setup-and-administration/trunk-sudo-ruleset-bypass-mode.png" />
</Frame>

#### Verify your setup

The settings page for each Trunk Merge Queue includes a live checklist that validates every piece of the Trunk Sudo configuration end-to-end. **This checklist is the source of truth for whether your setup is correct** - if the checklist is green, the app is ready to merge.

<Info>
  To see this checklist, go to a merge queue in the repo where you are setting up Trunk Sudo, then click the **Settings** tab.
</Info>

<Frame caption="Trunk Sudo setup checklist in the Merge Queue settings page when everything is configured properly.">
  <img src="https://mintcdn.com/trunk-4cab4936-automation-firewatch-docs-sync/bF34xrB5NUZaMQBn/assets/setup-and-administration/trunk-sudo-setup-checklist.png?fit=max&auto=format&n=bF34xrB5NUZaMQBn&q=85&s=0923aef0a9139d30a1d8fc1c2a1433fa" alt="Trunk Sudo setup checklist in the Merge Queue settings page" width="1540" height="840" data-path="assets/setup-and-administration/trunk-sudo-setup-checklist.png" />
</Frame>
