Skip to main content

GitLab Pages plugin for Certbot

Project description

GitLab Pages installer plugin for Certbot

certbot-gitlab is an installer plugin for Certbot. It allows you to automate the installation of certificates issued to GitLab Pages domains.

You still need to use a separate authenticator plugin. Read this for more information on how installer and authenticator plugins.


sudo pip install certbot-gitlab


Obtain as access token

Create an access token on GitLab with the api scope.

Basic Example

certbot --installer certbot-gitlab:gitlab

This will run Certbot interactively and allow you to choose your specific authentication method.

It will also ask for your GitLab access token. This won't be saved, so automatic renewal (via certbot renew) won't work. See Credentials File for how to automate renewal.

If you don't want automatic authentication, then add --authenticator manual --preferred-challenges dns to use manual DNS TXT record authentication.

Credentials File

certbot --installer certbot-gitlab:gitlab --certbot-gitlab:gitlab-token '/path/to/gitlab/token/file'

This will take the GitLab access token from /path/to/gitlab/token/file, which should contain just the access token, such as:


IMPORTANT: Make sure this file is in a secure location (such as /root/ or /etc/letsencrypt/keys/ and that it can only be read by root.

chown root:root '/path/to/gitlab/token/file'
chmod 600 '/path/to/gitlab/token/file'

The path to this file will be saved for automatic renewal, so running certbot renew will automatically install the certificate to GitLab when renewed.

All Options

--certbot-gitlab:gitlab-server CERTBOT_GITLAB:GITLAB_SERVER
                      GitLab server url (default:

--certbot-gitlab:gitlab-config CERTBOT_GITLAB:GITLAB_CONFIG
                      python-gitlab configuration file (default: None)

--certbot-gitlab:gitlab-token CERTBOT_GITLAB:GITLAB_TOKEN
                      GitLab API token (default: None)

--certbot-gitlab:gitlab-project CERTBOT_GITLAB:GITLAB_PROJECT
                      Name of GitLab project (e.g. user/proj) (default: None)

Read this for how to use --certbot-gitlab:gitlab-config.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

certbot-gitlab-0.1.0.tar.gz (3.5 kB view hashes)

Uploaded source

Built Distribution

certbot_gitlab-0.1.0-py2.py3-none-any.whl (4.2 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page