Skip to content

Installation

This guide will get you up and running with certonaut. We'll start with installing certonaut and then go over basic usage.

Supported platforms

  • Linux x86-64 (amd64)
  • Linux x86-32 (i386)
  • 🚧 Linux aarch64 [PLANNED, IN DEVELOPMENT]
  • 🚧 Windows x86-64 (amd64) [PLANNED, IN DEVELOPMENT]
  • 🚧 Windows aarch64 (amd64) [PLANNED, IN DEVELOPMENT]

Installing certonaut

[In the future, certonaut will offer binary downloads. These will be explained here. Right now, certonaut can only be build from source]

Building from source

Certonaut can be build in multiple configurations

Certonaut features an eBPF-based solver to automatically answer HTTP-01 challenges without webserver configuration. However, this solver requires several additional dependencies. You can also build a "lite" version of certonaut without these features. Below, you can select your intended configuration, which will show you build steps for the selected configuration.

Prerequisites

In order to build certonaut from source, you'll need the following tools installed on your machine:

  • The Rust compiler and its package manager cargo. On most platforms, the easiest way to get them is via the official installer, rustup.
  • A C/C++ compiler (1), clang (other compilers won't work, as eBPF requires compiler-specific features).
  • cmake, on Windows (2)
  • To build several C libraries from source (libelf, zlib, and libbpf), you also need C build tools: autoconf, autopoint, flex, bison, gawk, make and pkg-config.
  1. certonaut's main C/C++ dependency is aws-lc-rs. If you have trouble compiling the C libraries, you should probably review their compilation guide.
  2. certonaut's main C/C++ dependency is aws-lc-rs. If you have trouble compiling the C libraries, you should probably review their compilation guide.
  3. certonaut's main C/C++ dependency is aws-lc-rs. If you have trouble compiling the C libraries, you should probably review their compilation guide.
  4. certonaut's main C/C++ dependency is aws-lc-rs. If you have trouble compiling the C libraries, you should probably review their compilation guide.

On Debian/Ubuntu systems, you should install Rust via rustup and obtain the C dependencies via apt-get:

sudo apt-get update
sudo apt-get install --no-install-recommends \
    clang \
    build-essential \
    autoconf \
    autopoint \
    flex \
    bison \
    gawk \
    make \
    pkg-config

sudo apt-get update
sudo apt-get install --no-install-recommends build-essential

Compiling

Simply use cargo to compile & install:

cargo install --all-features --git https://github.com/certonaut/certonaut.git --bin certonaut

cargo install --git https://github.com/certonaut/certonaut.git --bin certonaut

If everything is succesful, the installed certonaut binary should be in ~/.cargo/bin/certonaut (which should also be in your path).

Next steps

After having installed certonaut, head over to usage