> ## 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)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.