32 lines
		
	
	
		
			1.3 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			32 lines
		
	
	
		
			1.3 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| # GitLab (self-hosted)
 | |
| 
 | |
| **Note:** *This guide was written before the renaming. Just replace `HackMD` with `HedgeDoc` in your mind 😃 thanks!*
 | |
| 
 | |
| 1. Sign in to your GitLab
 | |
| 2. Navigate to the application management page at `https://your.gitlab.domain/admin/applications` (admin permissions required)
 | |
| 3. Click **New application** to create a new application and fill out the registration form:
 | |
| 
 | |
|     
 | |
| 
 | |
| 4. Click **Submit**
 | |
| 5. In the list of applications select **HackMD**. Leave that site open to copy the application ID and secret in the next
 | |
|    step.
 | |
| 
 | |
|    
 | |
| 
 | |
| 6. In the `docker-compose.yml` add the following environment variables to `app:` `environment:`
 | |
| 
 | |
|     ```yaml
 | |
|     - CMD_DOMAIN=your.hedgedoc.domain
 | |
|     - CMD_URL_ADDPORT=true
 | |
|     - CMD_PROTOCOL_USESSL=true
 | |
|     - CMD_GITLAB_BASEURL=https://your.gitlab.domain
 | |
|     - CMD_GITLAB_CLIENTID=23462a34example99XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
 | |
|     - CMD_GITLAB_CLIENTSECRET=5532e9dexamplXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
 | |
|     ```
 | |
| 
 | |
| 7. Run `docker-compose up -d` to apply your settings.
 | |
| 8. Sign in to your HedgeDoc using your GitLab ID:
 | |
| 
 | |
|    
 |