Skip to content

Latest commit

 

History

History
 
 

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

README.md

backloop.dev renew

Renew and publish *.backloop.dev wildcard SSL certificate with Let's Encrypt and Gandi.

  • Outputs the certificates to gh-pages/ branch, published on https://perki.github.io/backloop.dev-renew/
  • The published certificates are used by the backloop.dev package

The renewal is managed by GithHub's workflow see (.github/worflows)[../.github/workflows].

Installation

  • npm install
  • npm run setup - clone gh-pages branch as a directory

Usage

Account creation

First you need to create an account on Letsencrypt with:

  • Staging: BACKLOOP_EMAIL={your email} node ./src/createAccount.js
  • Production: IS_PRODUCTION=true BACKLOOP_EMAIL={your email} node ./src/createAccount.js

Keep the values of Account key and Account Url respectively in environement variables ACME_ACCOUNT_KEY and ACME_ACCOUNT_URL, They will be used by the renewal script. You need to do this only once per environment.

Generate new certficates

To create new certificates, you need to set the following environement variables:

  • ACME_ACCOUNT_URL - generated on the previous step
  • ACME_ACCOUNT_KEY - generated on the previous step
  • GANDI_API_TOKEN - A gandi.net's ApiKey that allows to update your domain Read more

Run:

  • Staging: npm start
  • Production: IS_PRODUCTION=true npm start

Install

npm install

Run

GANDI_API_TOKEN=${KEY} npm start

to generate new SSL certificates into gh-pages/ (checkout of gh-pages branch of this repository)

Add IS_PRODUCTION=true to use Let's Encrypt's production API which has a call limit!

CONTRIBUTING

  • Pull requests are welcome

You may want to contribute to this repository to make it work for your own domain name or to support validation on other registar (DNS services) than gandi.net

License

BSD-3-Clause