Installation

Installation

SERP ships two packages:

Package	Contents
serp	Runtime shared libraries. Install on deployment targets that only need to run services, not build them.
serp-dev	Headers, CMake config, serpgen code generator, test engine, runtime debug adapters. Install on developer machines and CI.

For development, install serp-dev. It includes everything in serp plus the build-time tooling.

---

macOS — Homebrew (Recommended)

brew tap OleksandrGeronime/serp
brew trust OleksandrGeronime/serp
brew install OleksandrGeronime/serp/serp-dev

To install the runtime-only package instead:

brew install OleksandrGeronime/serp/serp

Upgrade:

brew update && brew upgrade OleksandrGeronime/serp/serp-dev

---

Ubuntu / Debian — .deb Package

Download both .deb files from the Releases page and install with dpkg.

Replace x.y.z with the version you want to install:

VERSION=x.y.z

wget https://github.com/OleksandrGeronime/serp/releases/download/v${VERSION}/serp_${VERSION}_amd64.deb
wget https://github.com/OleksandrGeronime/serp/releases/download/v${VERSION}/serp-dev_${VERSION}_amd64.deb

sudo dpkg -i serp_${VERSION}_amd64.deb
sudo dpkg -i serp-dev_${VERSION}_amd64.deb

If dpkg reports missing dependencies, resolve them with:

sudo apt-get install -f

Upgrade: Download the new .deb files and re-run dpkg -i. The package manager replaces the previous version in place.

---

Verify the Install

serpgen --version

This should print the installed version of serpgen. If the command is not found, check that the install location is on your PATH.

---

CMake Integration

Once serp-dev is installed, SERP exposes a standard CMake package through find_package(Serp REQUIRED).

Most serpgen-managed projects do not need hand-written deployment CMake wiring: generated CMakeLists.txt files link the correct Serp:: targets based on the deployment spec. For manual targets, available imported targets, and generated build layout, see CMake Integration.