Audience: Admin
Configuration Files
This document provides a complete reference for all critical configuration and state files within the NeuralDrive appliance.
Master File Inventory
| File | Purpose | Format | Owner |
|---|---|---|---|
/etc/neuraldrive/ollama.conf | Ollama baked-in defaults | KEY=VALUE | root:neuraldrive-admin |
/var/lib/neuraldrive/config/ollama.conf | Persistent Ollama overrides | KEY=VALUE | root:neuraldrive-admin |
/etc/neuraldrive/config.yaml | TUI overlay fallback config | YAML | root:neuraldrive-admin |
/var/lib/neuraldrive/config/config.yaml | Persistent TUI configuration | YAML | root:neuraldrive-admin |
/var/lib/neuraldrive/config/api.key | Persistent API key | plaintext | root:root (600) |
/etc/neuraldrive/api.key | System API key (synced) | plaintext | root:root (600) |
/var/lib/neuraldrive/config/credentials.conf | Persistent credentials | KEY=VALUE | root:root (600) |
/etc/neuraldrive/webui.env | Open WebUI configuration | KEY=VALUE | root:neuraldrive-admin |
/etc/neuraldrive/caddy.env | Caddy API key environment | KEY=VALUE | root:neuraldrive-admin |
/etc/neuraldrive/api.env | System API environment | KEY=VALUE | root:neuraldrive-admin |
/etc/neuraldrive/Caddyfile | Caddy reverse proxy configuration | Caddyfile | root:neuraldrive-caddy |
/etc/neuraldrive/nftables.conf | Global firewall rules | nftables | root:root |
/etc/neuraldrive/neuraldrive-models.yaml | Model catalog definitions | YAML | root:neuraldrive-admin |
/etc/neuraldrive/version | Build version string | plaintext | root:root |
/etc/neuraldrive/tls/server.crt | System TLS certificate | PEM | root:neuraldrive-caddy |
/etc/neuraldrive/tls/server.key | System TLS private key | PEM | root:neuraldrive-caddy (600) |
/etc/neuraldrive/tls/neuraldrive-ca.crt | Root CA for clients | PEM | root:root (644) |
/etc/neuraldrive/firewall-custom.conf | User-defined firewall rules | nftables | root:root |
/run/neuraldrive/gpu.conf | GPU detection results (at boot) | KEY=VALUE | root:root (runtime) |
Key Configuration Reference
ollama.conf
Defines the behavior of the underlying LLM inference engine. The Ollama service uses two configuration sources:
/etc/neuraldrive/ollama.conf— baked-in system defaults./var/lib/neuraldrive/config/ollama.conf— persistent user overrides.
Values in the persistent file override the system defaults.
OLLAMA_HOST=127.0.0.1:11434
OLLAMA_MODELS=/var/lib/neuraldrive/models/
OLLAMA_KEEP_ALIVE=5m
OLLAMA_MAX_LOADED_MODELS=0
OLLAMA_NUM_PARALLEL=1
OLLAMA_MAX_LOADED_MODELS: Set to 0 for "auto" mode. Ollama automatically manages how many models stay loaded based on available VRAM, using Least Recently Used (LRU) eviction when memory is required for a new request.
webui.env
Configures the Open WebUI chat interface and authentication.
OLLAMA_BASE_URL=http://localhost:11434
DATA_DIR=/var/lib/neuraldrive/webui
ENABLE_SIGNUP=false
DEFAULT_USER_ROLE=user
WEBUI_AUTH=true
WEBUI_NAME=NeuralDrive
ENABLE_EASTER_EGGS=false
api.key
This file contains the master authentication token (nd-xxxx) used to secure both the inference API and the system management API. It is generated during the first-boot initialization and should be treated with high sensitivity.
Caddyfile
NeuralDrive's reverse proxy configuration. It manages TLS termination and routing to internal services.
Note: For instructions on using your own TLS certificates, see TLS Certificates. To modify boot-time behavior, consult Boot Parameters.