📖 Reference

📖 Reference

Reference

The technical details behind every knob, endpoint, and configuration option.

HridaAI is highly configurable. This section is the canonical source of truth for environment variables, API endpoints, network architecture, reverse proxy setups, and production monitoring. Whether you're tuning a single setting or architecting a multi-node deployment, start here.

⚙️

Environment Variable Configuration

Every flag, path, and secret HridaAI reads at startup, in one place. Over 200 environment variables control authentication, model routing, storage, logging, and more. Understand ConfigVar behavior, troubleshoot ignored settings, and find the exact variable you need.

🔐Authentication & signup — ENABLE_SIGNUP, ENABLE_LOGIN_FORM, HRIDAAI_ADMIN_EMAIL, OIDC/LDAP/SCIM

🤖Model connections — Ollama, OpenAI, direct pipeline URLs, timeouts, load balancing

💾Storage & databases — SQLite, PostgreSQL, S3/GCS/Azure Blob, Redis

📊Logging & audit — GLOBAL_LOG_LEVEL, JSON logging, audit log levels and paths

🧠RAG & retrieval — Chunk size, overlap, embedding engines, reranking, vector DB selection

Browse all environment variables →→

🔌

API Endpoints

OpenAI-compatible and Anthropic-compatible APIs, plus RAG, file management, and Ollama proxy routes. HridaAI exposes a full REST API authenticated via Bearer tokens or JWTs. Use the same endpoints the web UI uses to build automations, chatbots, and custom integrations.

💬Chat completions — POST /api/chat/completions, OpenAI-compatible

🔮Anthropic messages — POST /api/v1/messages, works with the Anthropic SDK and Claude Code

🦙Ollama proxy — /ollama/api/*, passthrough to native Ollama endpoints

📄File & knowledge — Upload files, build knowledge collections, query via RAG

🔧Filters (inlet/stream/outlet) — Inlet, stream, and outlet hooks for every request

Explore the API →→

🔒

HTTPS Configuration

Terminate TLS in front of HridaAI with Nginx, Caddy, or HAProxy. Step-by-step reverse proxy configurations for securing your deployment with HTTPS. Each guide includes certificate handling, WebSocket support, and production-hardened settings.

🟢Nginx — Full config with SSL termination, WebSocket proxying, and headers

⚡Caddy — Automatic HTTPS with minimal configuration

🔄HAProxy — Enterprise-grade load balancing with TLS offloading

☁️Cloudflare Tunnel — Expose HridaAI securely without opening ports

🔒Tailscale — Private encrypted access across your devices, no public exposure

🧪ngrok — Instant HTTPS tunnels for development and testing

Set up HTTPS →→

🔑

API Keys

Programmatic access to HridaAI for scripts, bots, and integrations. Generate personal access tokens that let external code call the same endpoints the web UI uses. Each key inherits the permissions of the user who created it.

🔐Bearer token auth — Standard Authorization: Bearer header, works with any HTTP client

🛡️Scoped to user — Key inherits your role and group permissions

🚫Endpoint restrictions — Optionally limit which API routes a key can access

Set up API keys →→

📊

Monitoring

Observe your deployment with Uptime Kuma, OpenTelemetry, Prometheus, and Grafana. Production monitoring guides covering health checks, model connectivity verification, distributed tracing, metrics, and structured logs. Integrate with your existing observability stack or set up a new one from scratch.

✅Health checks — Basic, model connectivity, and deep health checks with Uptime Kuma

📡OpenTelemetry — Traces, metrics, and logs piped to any OTLP-compatible backend

📈Dashboards — Prometheus + Grafana for real-time system and model metrics

Set up monitoring →→

🌐

Network Diagrams

See how HridaAI, Ollama, and Docker communicate across different deployment topologies. Visual C4 diagrams covering host networking, Docker Compose stacks, separate networks, and platform-specific differences. Useful for debugging connectivity issues or planning your architecture.

🖥️macOS / Windows — Host Ollama, Compose stack, separate networks, host-network pitfalls

🐧Linux — Same topologies with Linux-specific networking behavior

View network diagrams →→