Deeployed Peer

Instance Integration

Learn how to connect your self-hosted instance to Deeployed Peer using OAuth.

Instance Integration

Connecting a self-hosted instance (like GitLab On-Premise) requires establishing a secure OAuth connection between your infrastructure and the Deeployed Dashboard.

Initiate Connection in Dashboard

Navigate to the Deeployed Dashboard and select the "Continue with self-hosted GitLab" option. Click on the "Add self-hosted instance" button to start the configuration.

Create OAuth Application in GitLab

On your GitLab instance (requires Admin privileges):

  1. Navigate to Admin Area > Applications.
  2. Create a New Application.
  3. Define the Required Scopes: api, read_user, openid, profile, email, read_repository.

Configure Redirect URI Enter the DNS address assigned to your Deeployed

Peer backend as the Redirect URI. This ensures secure communication between the two systems.

Finalize Dashboard Details

Return to the Deeployed Dashboard form and provide the following:

  • Display Name: A descriptive name for your instance.
  • Instance URL: The full address of your GitLab server (e.g., http://gitlab.local or http://192.168.1.101:port).
  • Application ID & Secret: Paste the credentials obtained from GitLab.

Once saved, you can now log in to the Dashboard using your own internal GitLab credentials.