Reference
Ports and environment variables
Ports
Everything listens on 127.0.0.1 only.
| Port | What |
|---|---|
8830 |
The dashboard |
8769 |
The Piper voice service (after the voice install) |
11434 |
Ollama, if you use it |
8456 |
The https port Tailscale publishes the dashboard on, when you use your own Tailscale |
443 |
The https port when JARVIS Ultra runs its own Tailscale node |
5173 |
The development server, only when you run scripts/dev.sh |
Environment variables
You rarely need these. To set one for the service, put a KEY=VALUE line in <root>/.jarvis-env (create the file if it is not there), then:
- on Linux, run
uv run scripts/service.py restart; - on macOS and Windows, run
uv run scripts/service.py install, which writes the values into the service.
| Variable | Default | What it changes |
|---|---|---|
JARVIS_PORT |
8830 |
The dashboard's port |
JARVIS_BIND |
127.0.0.1 |
The address the dashboard listens on. Leave it: Tailscale is the safe way in from elsewhere. |
JARVIS_ROOT |
The JARVIS Ultra folder | Where data/, logs/ and docs/ live |
JARVIS_DATA |
<root>/data |
The data folder |
JARVIS_LOGS |
<root>/logs |
The logs folder |
HERMES_HOME |
~/.hermes (Windows: %LOCALAPPDATA%\hermes) |
Hermes' home folder |
HERMES_BIN |
hermes on the PATH, else ~/.local/bin/hermes |
The Hermes command |
JARVIS_TAILNET_PORT |
8456 |
The default port to publish on your own Tailscale |
JARVIS_TAILSCALE_BIN |
Found automatically | The Tailscale command to use |
JARVIS_VOICE_URL |
http://127.0.0.1:8769 |
Where the dashboard finds the Piper voice service |
JARVIS_VOICE_PORT |
8769 |
The port install-voice.sh gives the voice service. If you change it, set JARVIS_VOICE_URL to match. |
JARVIS_OLLAMA_HOST, then OLLAMA_HOST |
127.0.0.1:11434 |
Where Ollama listens |
JARVIS_SERVICE_LABEL |
com.jarvis-ultra.app |
The service's name, for a second copy that must not clash |
JARVIS_LOG_STDERR |
1 |
0 stops the server copying its log to the terminal (the service sets 0) |
Hermes' own .env
These lines live in <hermes>/.env, not in .jarvis-env:
| Variable | What it is for |
|---|---|
TELEGRAM_BOT_TOKEN |
The bot that sends Telegram alerts and rule results |
TELEGRAM_HOME_CHANNEL |
Where Telegram messages go when Telegram chat id is blank |
ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY and others |
Provider keys. The dashboard writes these into every profile when you add a provider; you do not need to edit them. |