Skip to main content

Documentation Index

Fetch the complete documentation index at: https://trunk-4cab4936-mintlify-migrate-docs-changes-1778515731.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

For teams switching from GitHub Merge Queues to Trunk Merge Queue, the process is straight forward.
Looking for a more detailed comparison between Trunk and GitHub’s Merge Queues? Learn more

​
Turn off GitHub Merge Queue

To start, you will need to disable the exising merge queue for the target repository. This can be done by navigating to the repository and opening Settings > Branches > branch rule > toggle off Require merge queue. Be sure to click Save changes to confirm the settings.
Note that only users with admin permissions can manage merge queues for pull requests targeting selected branches of a repository. More information on manage merge queues can be found in the GitHub documentation.

​
Enable Trunk Merge Queue

Follow the Getting Started to setup your repo with Trunk Merge Queue and configure the settings for your repository.

​
Pre migration

Before migrating fully, it may be useful to evaluate the workflows “quiety” and confirm settings before converting your repository to an entirely new workflow. Here are some useful steps to get you familiar with the Trunk Merge Queue workflow without disrupting engineers.

​
Enable Trunk Merge for testing but with the automatic comments disabled

While evaluating and testing Trunk Merge Queue for your team, we suggest disabling automatic comments on PRs. This can be done by toggling off GitHub Comments in the Trunk web app. This setting is found under Merge Queue tab > repository > Settings > toggle off GitHub Comments.

​
Make the switch

Once you have configured settings and tested out the workflow quietly, turn off other merge tools (like GitHub merge queue), re-enable GitHub comments in the Trunk web app under the Merge Queue tab > repository > Settings > toggle on GitHub Comments
It is important that a repository is configured to use ONLY Trunk Merge Queue and no other merge queue tools for best results.

​
Share the news

Now that you have migrated to Trunk Merge Queue, be sure to share the workflow with your team, using-the-queueas a great place to start.

​
Getting help

If you or your team are running into issues be sure to join the Trunk Slack community for assistance.