---
title: CodexMobile Relay
sdk: docker
app_port: 7860
---

# CodexMobile Relay

This HuggingFace Docker Space runs the CodexMobile relay entrypoint.

Configure Space variables:

```text
CODEXMOBILE_MODE=relay
HOST=0.0.0.0
PORT=7860
CODEXMOBILE_RELAY_REQUEST_TIMEOUT_MS=120000
CODEXMOBILE_RELAY_HEARTBEAT_MS=15000
CODEXMOBILE_RELAY_IDLE_HEARTBEAT_MS=300000
CODEXMOBILE_RELAY_PENDING_REQUESTS_MAX=64
CODEXMOBILE_RELAY_BROWSER_PENDING_REQUESTS_MAX=6
CODEXMOBILE_RELAY_TOKEN_REQUESTS_PER_MINUTE=120
CODEXMOBILE_RELAY_TOKEN_REQUEST_WINDOW_MS=60000
```

Mac connector defaults to an unauthenticated HTTP keepalive against
`/api/status?keepalive=1` every 240000 ms. Active intervals below 60000 ms are
ignored. Set `CODEXMOBILE_RELAY_KEEPALIVE_MS=0` on the connector only when you
explicitly want to disable that Space wakeup traffic.

Configure Space secrets:

```text
CODEXMOBILE_RELAY_SECRET=<at-least-32-character-random-secret>
CODEXMOBILE_RELAY_PREVIOUS_SECRET=<optional-previous-secret-during-rotation>
```

Do not commit relay secrets, browser tokens, pairing codes, logs, or local state.