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):
- Navigate to Admin Area > Applications.
- Create a New Application.
- 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.localorhttp://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.