Skip to main content
How you migrate depends on how you originally installed Qodo on GitLab. This guide covers migrating to the Qodo 2.7 installation wizard.

​
Installed using the Qodo 2.3.3 installation wizard

No action is required. Your existing installation continues to operate as expected. The next time you open the installation wizard, for example to add more groups or projects, Qodo migrates your installation to the new system automatically and safely.

​
Installed manually (pre-wizard)

Launching the wizard gives you access to the Review Standards, findings, and other advanced code review features, improves overall performance and reliability, and ensures your installation appears on the Repositories page. The process involves noting your existing webhooks, installing Qodo using the new wizard, verifying it is working, and then removing the old setup to avoid conflicts. Without migrating, your existing installation will continue to work but you will not have access to advanced features such as rules and findings, and your installation will not appear on the Repositories page.
1

Note existing webhooks

Before installing, record the IDs of your existing Qodo webhooks. You will need these to identify which webhooks to remove during cleanup, so you do not accidentally delete webhooks created by the new installation.GitLab webhooks can be set at the group level or at the individual project level, depending on how your original installation was configured. Check both.Group webhooks
1
Go to your GitLab group.
2
Select Settings, then Webhooks.
3
Note any Qodo webhooks listed.
Project webhooks
1
Go to each project in your group.
2
Select Settings, then Webhooks.
3
For each Qodo webhook, click Edit and note the webhook ID from the URL. For example, in https://gitlab.com/group/project/-/hooks/80678936/edit, the webhook ID is 80678936.
2

Install Qodo using the new wizard

Your existing installation covers either all repositories in a group (if a group webhook was installed) or select repositories (if individual project webhooks were installed). Follow the installation wizard in the Qodo portal to complete your new GitLab setup, selecting all repositories to match your existing coverage or your desired new scope. Once the wizard is complete, return here to continue.
3

Verify the new installation is working

Before removing the old installation, confirm the new one is active.
1

Open a merge request

Open a merge request or use an existing one in any connected repository.
2

Post /config as a comment

Add /config as a comment on the merge request.
3

Check the response

If two installations are running, you will see two sets of 👀 reactions and duplicate comments on merge requests. Once you see the new installation responding as expected, proceed with the cleanup steps below.
4

Remove old webhooks

Delete only the webhooks whose IDs you noted in step 1. Do not delete webhooks created by the new installation.Group webhooks
1
Go to your GitLab group.
2
Select Settings, then Webhooks.
3
Delete each webhook whose ID matches one you noted in step 1.
Project webhooks
1
Go to each project where you noted a webhook.
2
Select Settings, then Webhooks.
3
Delete each webhook whose ID matches one you noted in step 1.
5

Remove the old access token

Delete the personal, project, or group access token that was created for the original installation.
1
Go to your GitLab profile or group settings, depending on the token type.
2
Select Access Tokens.
3
Revoke the token that was created for the original Qodo installation.
Your GitLab integration is now fully migrated to the new wizard. Qodo is running through the new installation on your selected repositories.

​
Next steps