Componentpedia / Listings / acme-rs

Last update: 12/05/2025

acme-rs

An ACME Client for Let's Encrypt written in Rust to request SSL/TLS certificates.

Latest version: 0.2.0 registry icon
Maintenance score
0
Safety score
0
Popularity score
72
Check your open source dependency risks. Get immediate insight about security, stability and licensing risks.
De-risk your app now
Security
  Vulnerabilities
Version Suggest Low Medium High Critical
0.2.0 0 0 0 0 0
0.1.0 0 0 0 0 0

Stability
Latest release:

0.2.0 - This version may not be safe as it has not been updated for a long time. Find out if your coding project uses this component and get notified of any reported security vulnerabilities with Meterian-X Open Source Security Platform

Licensing

Maintain your licence declarations and avoid unwanted licences to protect your IP the way you intended.

MIT   -   MIT License

Not a wildcard

Not proprietary

OSI Compliant

Latest Version

acme-rs

An ACME Client for Let's Encrypt written in Rust to request SSL/TLS certificates. This client follows the guidelines specified in RFC8555.

Contents

Features

  • acme-rs in its current state does only support the http challenge. The port 80 must not be blocked.
  • You have the option to generate you keypair for the certificate first before executing the client.
  • By default, acme-rs will send the request to the URL https://acme-v02.api.letsencrypt.org/directory. However, you can manually change the ACME Server URL by using the --server flag. Just make sure you pass in the URL pointing to the directory information. The client then fetches all paths for further requests from the endpoint.

This crate also exposes a libary which allows users to acquire a certificate within their own code. The documentation can be found on docs.rs. The main function exposed by the libary is generate_cert_for_domain.

Installation

The installation process is done via crates.io. To install the lates version of this tool just run

cargo install acme-rs

you could also specify the installation path (e.g. if you would like to install the tool system wide):

cargo install acme-rs --root /usr/local/bin

Usage

acme-rs is using the openssl rust wrapper crate to generate keys and the csr.

The client will store the certificate and the certificate chain in the files cert.crt and chain.crt

Request a certificate

You can request a certificate by using the following command: 

acme-rs [OPTIONS] --domain <domain> --email <email>

Options

By running the command acme-rs --help you can get an overview of all the commands available.

An acme client (RFC8555) written in the rust programming language

USAGE:
    acme-rs [FLAGS] [OPTIONS] --email <email> --domain <domain>

FLAGS:
    -h, --help       Prints help information
    -v, --verbose    Enables debug output
    -V, --version    Prints version information

OPTIONS:
    -d, --domain <domain>              The domain to register the certificate for
    -e, --email <email>
        --private-key <private-key>    An optional private key file (PEM format) to load the keys
                                       from
        --public-key <public-key>
    -s, --server <server>              The ACME server's URL