Getting Started

Installation

How to install uPKI RA from source, pip, or Docker.

Installation

Requirements

  • Python 3.12 or higher
  • pip / pipx / Poetry 1.8+
  • A running uPKI CA instance reachable on ZMQ ports 5000 and 5001

From PyPI

pip install upki-ra

Or with pipx to keep it isolated:

pipx install upki-ra

From source (development)

git clone https://github.com/circle-rd/upki-ra.git
cd upki-ra

# Install with Poetry
poetry install

# Or with pip in editable mode
pip install -e ".[dev]"

Docker

docker pull ghcr.io/circle-rd/upki-ra:latest

Or build locally:

docker build -t upki-ra .

Verify installation

upki-ra --version

Expected output:

upki-ra, version X.Y.Z

Next step

Continue to the Quick Start guide to initialise and start receiving ACME requests.

Copyright © 2026