MaleusMaleus

Connect GitLab to the workspace

Connect GitLab once at workspace level to create or import a repository whenever a project is created.

In the appSettings · Version ControlAdrien Maret, CTOUpdated November 10, 2026
On this page

The workspace GitLab connection avoids configuring every new project by hand. Once OAuth authorization is saved, Maleus can create a repository in a chosen GitLab namespace or link an existing repository directly from the new-project form.

This integration supports GitLab.com and self-managed GitLab instances. GitHub appears in the catalog as Coming soon, but it cannot yet be connected at this level.

This is a GitLab connection at Maleus workspace level, not a connection to a strict GitLab "organization" entity. The default namespace can be a group or subgroup the authorized account can access.

Before you start

You must be a workspace admin. In GitLab, prepare an OAuth application with:

  • the instance base URL, such as https://gitlab.com, with no trailing path;
  • the Redirect URI supplied by Maleus;
  • the api scope;
  • the Application ID and Application secret.

The OAuth application can be created from user, group or administration settings in GitLab, depending on your installation and governance.

The GitLab account that authorizes the connection acts for the whole workspace. Prefer a dedicated service account with access only to the relevant namespaces and repositories.

Connect GitLab

  1. Open Settings → Version Control.
  2. Choose GitLab under Your providers.
  3. Copy the Redirect URI shown by Maleus into the GitLab OAuth application and enable the api scope.
  4. In Maleus, enter the Instance URL, Application ID and Application secret.
  5. Click Save & authorize.
  6. In the GitLab window that opens, sign in with the intended account and accept the authorization.

Allow pop-ups for Maleus if the browser blocks the OAuth window. Credentials are encrypted per workspace and the Application secret is never displayed again after saving.

Version Control centralizes the workspace's Git providers.

Set repository automation defaults

An active connection opens the Repository defaults section.

  1. Enable Create a repository with every new project.
  2. Choose the Default namespace where repositories will be created.
  3. Choose a Default visibility supported by your GitLab instance, such as Private.

Changes are saved immediately. There is no Save button in this section.

The namespace and visibility become the defaults for every new repository.

What a project creator sees

When GitLab is connected, New project includes a Source control block with three choices:

ChoiceEffect
Create a new repositoryCreates an empty repository in the selected namespace and links it to the project.
Import an existing repositorySearches accessible GitLab repositories and links one. A repository already used by another project is marked In use.
No repository for nowCreates the project without a repository. One can be connected later under Settings → Git Repository.

Even when automatic creation is enabled, the project creator can choose another option before submitting the project.

The repository path, availability and visibility are checked before the project is created.

Repository creation is best-effort: the Maleus project remains created if GitLab refuses the operation. A toast reports the failure and setup can be completed later from the project's Git settings.

Re-authorize or disconnect

If GitLab revokes or expires the authorization, the page shows Needs re-authorization. Repository creation is then paused for new projects without affecting existing repositories.

  • Use Re-authorize to renew authorization with the intended GitLab account.
  • Use Disconnect from the page menu to remove the workspace connection.

Disconnecting GitLab does not delete any existing repository. Existing remotes stay attached to projects, but operations that relied on workspace OAuth authorization may fail until GitLab is reconnected. The automated workflow is no longer offered to new projects.