JARVIS UltraManualv1.31

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.