Registry / security / le-store-certbot

le-store-certbot

JSON →
library2.2.4jsnpmunverified

This is a storage strategy for Greenlock.js (ACME client) that maintains compatibility with Certbot's file structure and configuration files. Version 2.2.4 is the final release. The package is deprecated; users are strongly advised to migrate to le-store-fs, which preserves existing certificates and uses the same options. It supports file-based storage of Let's Encrypt certificates in the Certbot layout (accounts, archive, live, renewal). Common pitfalls include confusing it with le-store-fs and continuing to rely on Python config file support (removed in le-store-fs). Requires Greenlock.js and homedir as peer dependencies.

npm install le-store-certbot
INSTALL
IMPORT
SIG · LE-STORE-CERTBOT
L
le-store-certbot
securityjavascriptv2.2.4
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

default
import leStore from 'le-store-certbot'
import { create } from 'le-store-certbot'
Default export is the factory, not named export.
create
import leStore from 'le-store-certbot'; const store = leStore.create({...})
import { create } from 'le-store-certbot'; const store = create({...})
`create` is a method on the default export, not a named export.
require
const leStore = require('le-store-certbot').create({...})
const { create } = require('le-store-certbot'); create({...})
CommonJS default import works, but create is not a named export.

Shows how to create a le-store-certbot instance and attach it to Greenlock.js, with custom configDir and file paths.

const Greenlock = require('greenlock'); const leStore = require('le-store-certbot').create({ configDir: require('homedir')() + '/acme/etc', privkeyPath: ':configDir/live/:hostname/privkey.pem', fullchainPath: ':configDir/live/:hostname/fullchain.pem', certPath: ':configDir/live/:hostname/cert.pem', chainPath: ':configDir/live/:hostname/chain.pem', logsDir: require('homedir')() + '/tmp/acme/log', webrootPath: '~/acme/srv/www/:hostname/.well-known/acme-challenge', debug: false }); Greenlock.create({ store: leStore });
Debug
Known issues
deprecatedThis package is deprecated. Use le-store-fs instead.
fix
Replace with le-store-fs: npm uninstall le-store-certbot && npm install le-store-fs
affects: >=2.0.0
breakingPython config file support is dropped in le-store-fs. le-store-certbot may still read them but will not write.
fix
If you need Python config files, stick with le-store-certbot 2.2.x or migrate to le-store-fs and convert manually.
affects: >=2.2.0
gotchaNot suitable for ephemeral instances (Heroku, AWS Elastic Beanstalk) due to filesystem storage requirement.
fix
Use a different storage strategy such as le-store-inmemory or a database-backed store.
affects: >=1.0.0
Errors
Common errors & fixes
Cannot find module 'le-store-certbot'
Package not installed or renamed to le-store-fs
fix
npm install le-store-certbot@2.x (or better, migrate to le-store-fs)
leStore.create is not a function
Importing named export instead of default
fix
Use: const leStore = require('le-store-certbot'); then leStore.create(...)
ENOENT: no such file or directory, open '.../privkey.pem'
configDir path incorrect or directory doesn't exist
fix
Ensure configDir points to an existing directory, e.g., using homedir() + '/acme/etc'
Upgrade
Version history
2.2.4latest on npm
Audit
Dependencies
greenlockrequiredStorage strategy for Greenlock.js ACME client
homediroptionalResolves user home directory for default configDir paths
Agent activity
9 hits · last 30 days
node
8
Resources
le-store-certbot — npm install le-store-certbot · libregistry