Skip to main content
Nuphos connects to GitLab over OAuth: gitlab.com works out of the box, while self-hosted instances need a one-time OAuth app you create. Once connected, the agent can work with merge requests, pipelines, issues, and repository contents.

​
gitlab.com

1

Start the connection

In Integrations → Connect → GitLab, keep the host as https://gitlab.com and authorize. Your browser opens GitLab’s consent screen.
2

Approve and return

Approve the requested scopes. GitLab redirects back to the desktop app (via a nuphos://gitlab-callback link) and the connection completes.

​
Self-hosted GitLab

For a self-hosted instance you provide your own OAuth application:
1

Create an OAuth application on your GitLab

In your GitLab (Admin Area → Applications, or a group/user application), create an application with scopes api, read_user, read_repository, write_repository, and set the redirect URI to the value shown in the Nuphos dialog (it points at the Nuphos backend’s /gitlab-app/setup).
2

Enter the host and app credentials in Nuphos

Set the GitLab host to your instance URL (e.g. https://gitlab.example.com) and paste the Application ID and Secret, then authorize as above.
Nuphos applies SSRF protections to the GitLab host — private, loopback, and cloud-metadata addresses are rejected. Use a real, reachable HTTPS host.

​
What the agent can do

Read and act on merge requests, pipelines, issues, and repository content for the connected namespace.