Before you begin
- GitLab turned on for your workspace, and set up on your server. See Turn on connectors for your workspace. GitLab needs your server to have a public
httpsaddress, so it doesn’t work on a server Switch Console runs on your computer. If its card shows Unavailable, ask the administrator of your Switch server. - A gitlab.com account. Self-managed GitLab instances aren’t supported.
- Agents can do anything your GitLab account can. Every connection can write, and you can’t limit an agent to some projects. Turn GitLab on only for agents you’d trust with your whole account.
- Whether the agent asks for approval. It depends on the agent’s provider and settings. See Check whether an agent asks for approval.
Connect GitLab
1
Start the connection
In the Switch Console sidebar, select Connectors, then the Discover tab. Select GitLab, then Connect to Switch. Your browser opens, and Switch Console waits while you sign in.
2
Allow access
Sign in at GitLab with the account your agents should use, and allow access.
3
Return to Switch Console
When the page says you’re connected, close the tab. The GitLab page in Switch Console shows the account you connected as.
Cut off access
To stop one agent, open the agent’s page, select the plug icon, and turn GitLab off. To stop every agent, on the GitLab page under Connectors, select Disconnect.- Turning GitLab off for an agent: Access the agent already holds keeps working for up to two hours.
- Disconnecting: Switch revokes your GitLab sign-in, so access agents already hold may stop at once.
Next steps
Let your agents use your services
Connect another service, or check how approvals and cutting off access work

