Skip to main content

​
voicegw status

Show the configuration status of all providers.

​
Purpose

voicegw status displays a table of every provider defined in the config, whether it has credentials configured, and how many models are registered against it. This is the quickest way to verify your setup after editing voicegw.yaml or adding providers via the API.

​
Syntax

voicegw status [OPTIONS]

​
Options

FlagShortTypeDefaultDescription
--config-cstringautoPath to voicegw.yaml. Auto-discovered if omitted.
--project-pstringnullFilter to one project (validates the project id exists).

​
Output

A Rich-formatted table with three columns:
ColumnDescription
ProviderProvider name (e.g., deepgram, openai, whisper).
ConfiguredYes when an API key is set or the provider is local; No API key otherwise.
ModelsNumber of models registered for this provider across all modalities.

​
Examples

​
Show all provider status

voicegw status

         Provider Status
┌───────────┬────────────┬────────┐
│ Provider  │ Configured │ Models │
├───────────┼────────────┼────────┤
│ deepgram  │ Yes        │ 2      │
│ openai    │ Yes        │ 3      │
│ cartesia  │ Yes        │ 1      │
│ whisper   │ Yes        │ 1      │
│ ollama    │ Yes        │ 1      │
└───────────┴────────────┴────────┘

​
Filter by project

voicegw status --project tonys-pizza
Displays the same table but with the project name in the header. Returns an error if the project id does not exist.

​
Use a specific config file

voicegw status --config /etc/voicegateway/voicegw.yaml

​
Check for missing API keys

voicegw status
Look for providers showing No API key. Those need credentials before they can serve requests.

​
Exit codes

CodeMeaning
0Success.
1Config failed to load, or the specified project was not found.

​
voicegw doctor

For a deeper check, run voicegw doctor. It runs a numbered punch list of checks (config loads, providers configured, daemon up, dashboard reachable, smoke test passes, secret-key set if managed providers exist, etc.) and prints a fix step for each failure. No stack traces. No bare “see docs” pointers. 
voicegw doctor