Skip to main content
This guide covers advanced configuration options including binary registry, API keys, storage, LLM, and notifications.

Configuration File

Default location: ~/osmedeus-base/osm-settings.yaml Override with: osmedeus --settings-file /path/to/config.yaml

Adding New Binaries to Registry

The binary registry defines tools that can be installed via osmedeus install binary.

Registry Format

Create or modify registry-metadata.json:

Registry Fields

Using Custom Registry


API Keys Configuration

Configure API keys for external services in the global_vars section.

Configuration

Setting via CLI

Usage in Workflows


Usage in Workflows


LLM Configuration

Configure AI/LLM providers for the llm step type.

Configuration

Supported Providers

Usage in Workflows


Database Configuration

SQLite (Default)

PostgreSQL

Setting via CLI


Server Authentication

Simple Auth (Username/Password)

JWT Configuration

API Key Authentication

When enabled, all API requests require header: x-osm-api-key: your-secure-api-key

Setting via CLI


Scan Tactics

Configure thread counts for different scan intensities:
Usage:

Environment Paths


Quick Setup Checklist

  1. Install binaries: osmedeus install binary --all
  2. Set API keys: osmedeus config set global_vars.GITHUB_API_KEY ghp_xxx
  3. Configure auth: osmedeus config set server.password secure123
  4. Test config: osmedeus config list
  5. Validate setup: osmedeus health