hedgedoc/docs/content/guides/auth/gitlab-self-hosted.md
David Mehren 80d8cc79f6
Docs: Unify code block languages
Use `yaml` for Dockerfiles, `shell` for environment variables and `json` for our config file.

Signed-off-by: David Mehren <git@herrmehren.de>
2021-01-11 12:00:33 +01:00

1.2 KiB

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:

New GitLab application

  1. Click Submit
  2. In the list of applications select HackMD. Leave that site open to copy the application ID and secret in the next step.

Application: HackMD

  1. In the docker-compose.yml add the following environment variables to app: environment:
- 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
  1. Run docker-compose up -d to apply your settings.
  2. Sign in to your HedgeDoc using your GitLab ID:

Sign in via GitLab