> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rime.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fix common issues with the Rime CLI.

## "no API key configured"

`rime usage` reports this when no key is stored; the TTS commands instead fail with "authentication failed: invalid API key". Run `rime login` or set the environment variable:

```bash theme={null}
export RIME_CLI_API_KEY=your_key_here
```

## "authentication failed: invalid API key"

Verify your API key at [app.rime.ai/tokens](https://app.rime.ai/tokens). Then run `rime login` again.

## "unsupported format: ... (supported: wav, mp3)"

The CLI writes only WAV or MP3. `mist` and `mistv2` default to MP3, and the other models default to WAV; the API, not the CLI, rejects a format a model cannot serve. Select a supported format explicitly:

```bash theme={null}
rime tts "Hello" -s cove -m mistv2 -f mp3
```

## No audio playback

* Check your system audio output settings
* Try saving to a file instead: `rime tts "Hello" -s astra -m coda -o output.wav`
* Headless builds (e.g., Docker) require `-o FILE` since playback is disabled

## "command not found: rime"

If you installed via the shell script, open a new terminal window or run:

```bash theme={null}
source ~/.zshrc   # or ~/.bashrc
```