olace

[ daemon & cli ]

Configuration

The daemon keeps its state in ~/.olace/. Most settings have a first-class home in the app or the CLI; the file is there when you want to look under the hood.

Files under ~/.olace

FileWhat it is
daemon.jsonConfiguration. The one file you might edit.
identity.encEncrypted device identity for end-to-end encryption. Do not copy between machines.
peers.json, host_peers.jsonCached pairing state.
chats/CLI chat sessions (attachments stay where they are; sessions store references).
logs/daemon.logThe daemon log, rotated.
bin/The daemon binary and the olace command.

Settings with CLI commands

Prefer these over editing the file; changes apply within about a second, no restart needed:

olace settings                       # show current settings and live state
olace settings keep-alive 30         # 5, 10, 15, 30, 60, 120, or always
olace settings auto-optimize on      # Flash Attention + KV cache quantization
olace settings context auto          # or a floor: olace settings context 32768

All three also accept --device <host> to configure a paired computer remotely.

daemon.json keys

KeyDefaultMeaning
api_urlhttps://api.olace.appOlace backend.
ollama_urlhttp://localhost:11434Where Ollama listens.
lmstudio_urlhttp://localhost:1234Where llmster, LM Studio's headless daemon, listens.
llamacpp_urlhttp://127.0.0.1:8143Where llama.cpp listens.
llamacpp_managedtrueOlace installs and runs llama.cpp itself. false attaches to a server you run.
llamacpp_binary_pathemptyPin a specific llama-server. Empty means the build Olace manages.
local_api_port5577Loopback health API port.
enabledtrueMaster switch for daemon duty.
keep_alive_minutes30Model residency in GPU memory. -1 means always.
auto_optimizetrueFlash Attention + KV cache quantization where safe.
local_context_modeautoauto or custom context sizing.
local_context_target32768Requested context floor when custom.
bridge_enabledfalseThe Olace Bridge listener.
bridge_port5578Bridge port, 1024 to 65535.
bridge_api_keyemptyBearer key for the Bridge. Empty means no auth, loopback only.
bridge_cors_originsemptyBrowser origins allowed to call the Bridge.
metrics_opt_infalseAnonymous reliability metrics. Never content, never identifiers.
log_levelinfodebug, info, warn, or error. Applies live.

Auth tokens and device identifiers also live in this file; treat it as private. The daemon, the app, and the CLI coordinate writes safely, and a corrupted file is quarantined and rebuilt rather than crashing the service.