Skip to content

Installation

Quick Start

The recommended way to install Strix is with the Linux setup wizard. It handles SSL, secure passwords, Docker Compose, and database initialization:

curl -sfL https://raw.githubusercontent.com/zaneGittins/strix/main/scripts/install.sh | sh

To upgrade an existing installation (if strix-setup is already installed):

sudo strix-setup --upgrade

This automatically checks for a newer version of strix-setup itself, downloads it if available, then runs the upgrade.

Architecture

graph TB
    users["Users / Browsers"]
    sources["Log Sources"]

    subgraph docker ["Docker Network"]
        caddy["Caddy<br/><small>Reverse Proxy + TLS</small>"]
        strix["Strix<br/><small>Go Backend + Web UI</small>"]
        pg[("PostgreSQL<br/><small>Users, Config, Alerts</small>")]
        ch[("ClickHouse<br/><small>Log Storage</small>")]
        litellm["LiteLLM<br/><small>AI Proxy</small>"]
    end

    users -- "HTTPS :443" --> caddy
    sources -- "HTTPS :443" --> caddy
    caddy -- ":8080" --> strix
    caddy -. "Access Logs" .-> strix
    strix -- ":5432" --> pg
    strix -- ":9000" --> ch
    strix -- ":8000" --> litellm
    litellm -. "OpenAI / Anthropic API" .-> ext["LLM Providers"]

System Requirements

Strix is supported on Linux x86_64 (amd64). The installer and pre-built binaries target this architecture.

Hardware Sizing

Recommended hardware for single-node Docker Compose deployments based on daily raw log volume.

Daily Ingest CPU Cores RAM Profile
10 GB 4 8 GB Small team, single application
50 GB 8 16 GB Multiple applications
100 GB 16 32 GB Department-level collection
250 GB 16 64 GB Multi-team or business unit
500 GB 32 128 GB Enterprise-wide collection

For disk, plan roughly 60 GB of storage per 10 GB/day ingested at 30-day retention. ClickHouse typically achieves 7-10x compression on structured log data. SSD minimum, NVMe recommended.