Skip to main content
Package managers not yet available β€” The installation methods below (brew install, install script) will not work until public launch. During closed alpha, you’ll receive a direct download link after requesting access.
Install Cerulion with a single command
One command. Everything included. The installer sets up the Cerulion CLI, core libraries, and shell completions automatically.

​
Quick Install

Copy and run the command for your platform: 
brew install cerulion/tap/cerulion
Installs on both Intel and Apple Silicon Macs

​
Verify Installation

Run this command to confirm everything is working: 
cerulion doctor
You should see output like this: 
Cerulion v0.1.0

Platform:    darwin-arm64
Shell:       zsh (completions installed)

Components:
  βœ“ CLI          v0.1.0
  βœ“ Core         v0.1.0
  βœ“ iceoryx2     ready
  βœ“ zenoh        ready

All systems operational.

​
What Gets Installed

Cerulion CLI

Command-line interface for managing projects, validating schemas, and running nodes

Cerulion Core

Rust library with zero-copy pub/sub, automatic serialization, and dual transport

Shell Completions

Tab completions for bash, zsh, and fish β€” installed automatically
Cerulion’s dual-transport architecture

​
Platform Details

Requirements:
  • macOS 12 (Monterey) or later
  • Homebrew package manager
What happens:
  1. Adds the Cerulion tap: cerulion/tap
  2. Installs the universal binary (Intel + Apple Silicon)
  3. Sets up zsh completions automatically
Alternative β€” Direct download:
curl -L "https://get.cerulion.com/macos" -o cerulion.tar.gz
tar -xzf cerulion.tar.gz
sudo mv cerulion /usr/local/bin/
Requirements:
  • glibc 2.31+ (Ubuntu 20.04+, Debian 11+, Fedora 36+)
  • curl or wget
What the script does:
  1. Detects your architecture (x86_64 or aarch64)
  2. Downloads the appropriate binary
  3. Installs to ~/.local/bin (or /usr/local/bin with sudo)
  4. Sets up shell completions for your detected shell
Manual installation:
# x86_64
curl -L "https://get.cerulion.com/linux-x86_64" -o cerulion.tar.gz

# ARM64
curl -L "https://get.cerulion.com/linux-aarch64" -o cerulion.tar.gz

tar -xzf cerulion.tar.gz
mv cerulion ~/.local/bin/
Shell completions:
# Bash
cerulion completions bash >> ~/.bashrc

# Zsh
cerulion completions zsh >> ~/.zshrc

# Fish
cerulion completions fish > ~/.config/fish/completions/cerulion.fish
Why WSL2?Cerulion’s zero-copy transport uses shared memory (iceoryx2), which requires POSIX-compatible APIs. WSL2 provides a full Linux kernel that supports these operations natively.Setup steps:
1

Enable WSL2

Open PowerShell as Administrator:
wsl --install -d Ubuntu
Restart your computer when prompted.
2

Open Ubuntu

Launch β€œUbuntu” from the Start menu and complete the initial setup.
3

Install Cerulion

Inside the Ubuntu terminal:
curl -fsSL https://get.cerulion.com | sh
4

Verify

cerulion doctor
For the best experience, use Windows Terminal and VS Code with the WSL extension.
Official image:
docker pull cerulion/cerulion:latest
Run interactively:
docker run -it --rm cerulion/cerulion:latest cerulion doctor
Use in Dockerfile:
FROM cerulion/cerulion:latest
COPY . /app
WORKDIR /app
RUN cerulion build
The Docker image includes all dependencies and is ideal for CI/CD pipelines.

​
Upgrading

Cerulion can update itself: 
cerulion upgrade
This downloads the latest signed release, verifies the signature, and replaces the binary. Your configuration and projects are preserved.
Run cerulion upgrade --check to see if an update is available without installing it.

​
Uninstalling

brew uninstall cerulion
brew untap cerulion/tap
Configuration files in ~/.config/cerulion/ are preserved. Remove them manually if needed.

​
Troubleshooting

The binary isn’t in your PATH. Add it:
# For ~/.local/bin installation
export PATH="$HOME/.local/bin:$PATH"
Add this line to your ~/.bashrc, ~/.zshrc, or shell config file.
The install script needs write access. Either:
# Install to user directory (no sudo needed)
curl -fsSL https://get.cerulion.com | sh

# Or install system-wide with sudo
curl -fsSL https://get.cerulion.com | sudo sh
Shared memory transport requires proper permissions:
# Check shared memory limits
cat /proc/sys/kernel/shmmax

# Increase if needed (requires root)
sudo sysctl -w kernel.shmmax=2147483648
On Docker, run with --ipc=host or --shm-size=1g.
If macOS blocks the binary:
xattr -d com.apple.quarantine /usr/local/bin/cerulion
Or open System Preferences β†’ Security & Privacy β†’ Allow.

​
Upcoming Features

Python SDK

Coming Soonpip install cerulion β€” Native Python bindings with async/await support. Join the waitlist.

C++ SDK

Coming SoonHeader-only library with CMake integration. Perfect for embedded and robotics applications.

​
Next Steps

Quickstart

Build and run your first Cerulion project in 5 minutes

CLI Commands

Explore everything the CLI can do