Server Configuration

Configure Torque with CLI arguments, environment variables, or a TOML config file. Settings resolve in order: CLI args > environment variables > TOML file > defaults.

CLI Arguments

Memory Configuration

GPU Configuration

GPU acceleration is enabled automatically when a CUDA-capable NVIDIA GPU is detected. If no GPU is available, Torque falls back to CPU with no configuration change required.

Compaction

Environment Variables

Every configuration option has a corresponding environment variable with the TORQUE_ prefix:

TOML Configuration File

Create a torque.toml file in the working directory (auto-detected) or specify the path with --config:

# torque.toml
api_key = "your-api-key"
api_addr = "0.0.0.0:8108"
ingest_addr = "0.0.0.0:8109"
data_dir = "./data"
log_level = "info"

# CORS
cors_origins = ["https://app.example.com", "http://localhost:3000"]

# TCP ingest allowlist (empty = allow all)
ingest_allow = ["10.0.0.0/8", "192.168.1.0/24"]

# Memory
max_memory_percent = 90
# max_http_body_bytes = 134217728  # default: unlimited
max_vector_memory_gb = 16
max_ingest_connections = 64
query_timeout_ms = 10000

# GPU
gpu_vram_budget_mb = 0

# Compaction
compaction_interval_secs = 1800
compaction_memory_threshold_percent = 80
overlay_flush_interval_ms = 1000

# License
license_key = "tskey_..."
api_base = "https://api.truespar.com"

# TLS (requires --features tls build)
# tls_cert = "/etc/torque/cert.pem"
# tls_key = "/etc/torque/key.pem"

# Logging
# log_dir = "/var/log/torque"
# slow_query_ms = 100

TLS / HTTPS

Torque supports TLS encryption for the HTTP API:

# Start with TLS
torque-server --api-key KEY --tls-cert /path/to/cert.pem --tls-key /path/to/key.pem

When TLS is enabled, Studio and all API endpoints are served over HTTPS. The TCP ingest port does not use TLS.

Windows Service

On Windows, Torque can be installed and run as a Windows Service:

# Install the service (uses current CLI arguments)
torque-server --service-install --api-key YOUR_API_KEY --data-dir C:\torque\data

# Uninstall the service
torque-server --service-uninstall

Once installed, the service can be managed through the Windows Services manager (services.msc) or the command line:

# Start the service
net start TorqueServer

# Stop the service
net stop TorqueServer

Ports

Torque uses two ports by default:

Persistence

Torque persists data to the data_dir directory automatically. On restart, collections, indexes, aliases, API keys, synonyms, presets, and stopwords are restored from disk. No re-ingestion is required.

Persistence is enabled by default. The data directory contains:

• Collection schemas and metadata
• Compressed binary index data (per collection)
• Alias mappings
• API keys, synonym sets, presets, and stopword sets
• Realtime overlay data (for collections in realtime ingest mode)

Configuration Priority

When the same setting is specified in multiple places, higher-priority sources override lower ones:

1. CLI arguments (highest priority)
2. Environment variables
3. TOML config file
4. Built-in defaults (lowest priority)