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

# moorcheh-edge voice serve

> HTTP server for voice RAG on edge hardware (default port 8766).

## Synopsis

```bash theme={null}
moorcheh-edge voice serve [options]
```

Starts a small HTTP server on the edge device so a **remote display PC** can drive mic capture, TTS playback, and streaming RAG without direct access to ALSA hardware.

<Note>
  **Linux only** - intended for edge boards such as the Arduino UNO Q. Run [`voice setup`](/cli/voice/setup) once before first use.
</Note>

## Options

| Flag         | Default                 | Description                          |
| ------------ | ----------------------- | ------------------------------------ |
| `--host`     | `0.0.0.0`               | Bind address                         |
| `--port`     | `8766`                  | HTTP port                            |
| `--base-url` | `http://127.0.0.1:8080` | Moorcheh Edge API used for RAG       |
| `--timeout`  | `300`                   | HTTP timeout for RAG calls (seconds) |

## Examples

```bash theme={null}
moorcheh-edge voice serve
moorcheh-edge voice serve --port 8766 --base-url http://127.0.0.1:8080
```

On startup, the CLI prints the listen URL and available routes.

## Typical deployment

| Machine       | Service                     | Port                |
| ------------- | --------------------------- | ------------------- |
| Arduino UNO Q | Moorcheh Edge (Docker)      | `8080`              |
| Arduino UNO Q | `moorcheh-edge voice serve` | `8766`              |
| Display PC    | Your kiosk API / UI         | e.g. `8765`, `5173` |

Point the PC app at `http://<UNO_Q_IP>:8766` for voice endpoints. See [Voice server API](/api-references/voice-serve) for request and response formats.

## Related

* [Voice server API](/api-references/voice-serve)
* [API: Answer stream](/api-references/answer-stream)
* [Retail Kiosk example](/examples/retail-kiosk)
* [Voice CLI overview](/cli/voice/introduction)