isabella232 / sslmate

The SSLMate Client - Buy and Manage SSL Certs from the Command Line

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

• Run sslmate help.
• Read the sslmate(1) man page.
• Consult SSLMate's help documentation.
• Email [email protected] or tweet to @SSLMate.