Skip to main content
The CLI and SDK use a global configuration for authentication and API host. This is separate from project-level omium.toml.

​
Config file

After you run omium init, settings are stored in:
  • macOS / Linux: ~/.omium/config.json
  • Windows: %USERPROFILE%\\.omium\\config.json
Typical fields:
FieldMeaning
api_keyAPI key (starts with omium_)
api_urlAPI host URL, e.g. https://api.omium.ai (no /api/v1)
regionOptional region identifier

​
Environment overrides

Environment variables override the config file. This is the recommended approach for servers and CI.
VariableMeaning
OMIUM_API_KEYAPI key
OMIUM_API_URLAPI host URL (no /api/v1)
OMIUM_DEBUGEnable debug logs
export OMIUM_API_KEY=omium_your_key_here
export OMIUM_API_URL=https://api.omium.ai

​
Hosted API URL

For hosted Omium:
  • OMIUM_API_URL=https://api.omium.ai
The CLI and SDK append /api/v1 where needed.