The SSLMate Client - Buy and Manage SSL Certs from the Command Line
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
libexec/sslmate/approval
man
perllib
share/sslmate/dhparams
.gitignore
COPYING
Makefile
NEWS
README
README.md

README.md

SSLMate command line client

sslmate is the command line client for SSLMate, a service for purchasing and managing SSL certificates. SSLMate provides easy-to-use tools for buying, renewing, and revoking certificates, for monitoring the expiration date of your certificates, and for synchronizing your certificates between your servers.

SSLMate emphasizes speed, ease-of-use, and automation. For example, the command to purchase a certificate (sslmate buy) typically completes in under a minute and automates the steps of generating a private key, generating a CSR, and building a certificate bundle. SSLMate can automatically renew your certificates, and you can run sslmate download from a cron job so that renewed certificates are automatically downloaded to your server.

To use the sslmate command, you must create a free account at https://sslmate.com.

Dependencies

SSLMate officially supports:

  • Debian 7, 8, and 9
  • Ubuntu 12.04, 14.04, 15.04, 15.10, 16.04, 16,10, and 17.04
  • RHEL/CentOS 6 and 7
  • Fedora 20 and above
  • Arch Linux (available in the AUR)
  • Mac OS X 10.9 and above (available from Homebrew)

Packages (.deb, .rpm, and .pkg) for the above operating systems are available.

SSLMate can run on other Unix-based operating systems provided the following software is installed:

  • Perl v5.10.0 or newer.

  • The following Perl modules, which can be installed by running cpan MODULENAME or by installing the corresponding distro package.

    Module Name               Debian/Ubuntu Package       RHEL/CentOS Package
    -----------------------------------------------------------------------------
    URI                       liburi-perl                 perl-URI
    Term::ReadKey             libterm-readkey-perl        perl-TermReadKey
    JSON::PP [1]              libjson-perl                perl-JSON
    LWP (>= 6) [2]            libwww-perl                 perl-libwww-perl
    LWP::Protocol::https [2]  liblwp-protocol-https-perl  perl-LWP-Protocol-https
    

Notes:

  1. JSON::PP is included with Perl 5.14 and later.
  2. LWP is optional; if not available SSLMate will fall back to executing the curl command directly.

Optional Dependencies

To use automatic DNS approval with Route 53, the following additional software must be installed:

  • Python 2.6, Python 2.7, Python 3, or newer.
  • Boto (Python module) 2.2 or newer.
    • Debian/Ubuntu package: python-boto (on Debian 6, requires backports)
    • RHEL/CentOS package: python-boto (requires EPEL repository)

Installation

Run make and make install.

The following Makefile variables can be passed on the command line to make and make install:

  • PREFIX=/path - Install to given path (default: /usr/local)
  • DESTDIR=/path - Stage installed files under the given path instead of installing directly to the filesystem (intended for package building)

Example:

make PREFIX=/usr
make install PREFIX=/usr DESTDIR=/tmp/pkgroot

Getting started

See SSLMate's guide to getting started.

Getting help