HackMD/docs/guides/auth/gitlab-self-hosted.md
Sheogorath 97a08e7954
Add note about renaming to docs
It's way easier to add a note to the guides than to redo all the images,
etc. We have more important things to spend our time on, but if someone
wants to redo them, you are very welcome!

Signed-off-by: Sheogorath <sheogorath@shivering-isles.com>
2018-06-24 14:06:32 +02:00

1.2 KiB

GitLab (self-hosted)

===

Note: This guide was written before the renaming. Just replace HackMD with CodiMD 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:
- HMD_DOMAIN=your.hackmd.domain
- HMD_URL_ADDPORT=443
- HMD_PROTOCOL_USESSL=true
- HMD_GITLAB_BASEURL=https://your.gitlab.domain
- HMD_GITLAB_CLIENTID=23462a34example99XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
- HMD_GITLAB_CLIENTSECRET=5532e9dexamplXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  1. Run docker-compose up -d to apply your settings.
  2. Sign in to your HackMD using your GitLab ID:

Sign in via GitLab