Docker

Warning

The BFH LaTeX Docker image is available exclusively to BFH members.

Warning

We recommend choosing a specific tag at all times instead of latest. However, you will see latest in the documentation, replace it with any version tag of the BFH CI releases - starting from 2.2.3.

Prerequisites

To use the Docker image, you must have Docker installed and need to be logged-in to our registry on GitLab (see below).

Logging in to the Docker registry

This must be done on a terminal (PowerShell, bash, …); the commands stay the same regardless of which one you use.

Warning

For the login to succeed, you need a personal access token from GitLab. Plain username and password will not work!

To create an access token, head to your profile page on Gitlab (direct link: gitlab.ti.bfh.ch), then:

  1. Click Add new token

  2. Give it a meaningful name (e.g. bfh-latex-pull-token)

  3. Select the maximum expiration possible

  4. Select read_registry scope only

  5. Click Generate token

The token will then be displayed to copy, make sure to copy the value, it will only be shown once! Open a terminal and login to the registry:

$ docker login registry.gitlab.ti.bfh.ch -u <YOUR_GITLAB_USERNAME>
Password:

When asked, paste the copied token from before.

Finally try to pull our image to see if the login was successful:

$ docker pull registry.gitlab.ti.bfh.ch/bfh-latex/registry/bfh-ci:latest
...

Note

Should the pull fail in the future with access denied, it’s likely your token has expired. Repeat the token creation and login again.

Further reading:

Next Steps

Continue reading the Docker section in Tools and Editors to understand how the image can be used.