Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

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

Release history Release notifications

Download files

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

Files for certbot-gitlab, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size certbot_gitlab-0.1.0-py2.py3-none-any.whl (4.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size certbot-gitlab-0.1.0.tar.gz (3.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page