Configuration
Daemon (.env)
npm run daemon reads .env in the repo root.
| Variable | Default | |
|---|---|---|
DESKPHONE_ARI_URL | http://127.0.0.1:8088/ari | Comma-separated ARI base URLs, tried in order. The daemon holds the first that answers and starts over from the top if it drops. |
DESKPHONE_ARI_USER | deskphone | |
DESKPHONE_ARI_PASSWORD | deskphone | Must match ARI_PASSWORD in asterisk/.env. |
DESKPHONE_ENDPOINT | PJSIP/phone | What callbacks dial until a phone has called in, or always with DESKPHONE_FOLLOW_LAST_PHONE=false. |
DESKPHONE_FOLLOW_LAST_PHONE | true | Ring the phone that last dialed in, unless the session is pinned to one. |
DESKPHONE_VOICE | system voice | say -v voice name. |
DESKPHONE_VOICE_LANGUAGE | en | Language of DESKPHONE_VOICE. Replies detected in another language use an installed voice for that language instead. |
DESKPHONE_VOICE_<LANG> | best installed | Voice for one language, e.g. DESKPHONE_VOICE_NL="Xander". Short replies that can’t be recognized clearly also lean toward that language. |
DESKPHONE_LANGUAGE | auto | Whisper language (en, nl, …). Fixing it is faster and more accurate than auto. When set, short replies that can’t be recognized clearly lean toward this language. |
DESKPHONE_WHISPER_MODEL | models/ggml-small.bin | |
DESKPHONE_WHISPER_BIN | whisper-cli | |
DESKPHONE_RING_SECONDS | 30 | How long a callback rings before going to voicemail. |
DESKPHONE_REPLY_WAIT_MS | 8000 | Silence after the beep on a callback before it hangs up. |
DESKPHONE_VAD_THRESHOLD | 500 | Speech level (RMS of 16-bit samples). Lower it if quiet speech isn’t picked up. |
DESKPHONE_MAX_SPEECH_CHARS | 900 | Longer replies are cut, with “the rest is on screen”. |
DESKPHONE_PHONES_FILE | ~/.config/deskphone/phones.json | Phones added with phone_device_add, with their SIP passwords. |
DESKPHONE_PIN_FILE | ~/.config/deskphone/pin | Where npm run set-pin stores the PIN hash. |
DESKPHONE_VOICEMAIL_FILE | ~/.config/deskphone/voicemail.json | Where waiting voicemail is kept across daemon restarts. |
DESKPHONE_PORT | 7788 | Local control API, bound to 127.0.0.1. |
The plugin’s channel server and Stop hook find the daemon at DESKPHONE_URL (default http://127.0.0.1:7788).
Asterisk (asterisk/.env)
| Variable | |
|---|---|
PHONE_PASSWORD | SIP password of the phone account, which the ATA uses. |
ARI_PASSWORD | Password of the deskphone ARI user, which the daemon uses. |
EXTERNAL_IP (the address or hostname advertised to phones) and SIP_PORT are set in docker-compose.yml and kubernetes/deployment.yaml.
Extensions
| Dial | |
|---|---|
101#–199# | A Claude session, in the order sessions register. A session asks for its previous extension back after a daemon restart. |
100# | Menu: 1 (or wait a few seconds) plays voicemail for all sessions, 2 reads out the registered sessions. |