Configuration

This page describes how to configure Corvus via a TOML file or CLI flags.

Quick Start

Create a config file (for example, config/corvus.toml):

[corvus]
host = "0.0.0.0"
port = 4499

[broker]
url = "https://your-context-broker.example.com"
user_agent = "Corvus/0.1.0"

[http]
timeout_secs = 30

[purge]
page_size = 100
max_concurrent_deletes = 20
max_retries = 5
initial_retry_delay_ms = 1000

Configuration Reference

Section

Option

Default

Description

corvus

host

0.0.0.0

Bind address

corvus

port

4499

Listen port

broker

url

—

Base URL of the NGSI-LD context broker

broker

user_agent

Libra

User-Agent for broker requests

http

timeout_secs

30

HTTP request timeout

purge

page_size

100

Items per page when fetching entities

purge

max_concurrent_deletes

20

Max concurrent DELETE requests (temporal purge)

purge

max_retries

5

Retries per request on transient errors

purge

initial_retry_delay_ms

1000

Initial retry delay (exponential backoff)

All options can be overridden via CLI flags (for example, --broker-url, --purge-page-size). Run corvus --help for the full list.