Installation

Quick Start with Docker

The fastest way to get Sophon running:

docker compose up -d

Open your browser to http://localhost:8080 — the Setup Wizard will guide you through configuration.

System Requirements

Component	Minimum	Recommended
CPU	2 cores	4+ cores
RAM	2 GB	8+ GB
Disk	1 GB	10+ GB
Docker	24.0+	Latest
.NET	10.0	10.0

Docker Compose (Personal Tier)

Create a docker-compose.yml:

services:
  sophon-gateway:
    image: buildersoftdev/sophon:latest
    ports:
      - "8081:8080"
    volumes:
      - ${SOPHON_DATA}:/home/sophon/.sophon
    environment:
      - SOPHON__Tier=Personal
      - SOPHON__DataDirectory=/home/sophon/.sophon
    restart: unless-stopped

  sophon-dashboard:
    image: buildersoftdev/sophon-dashboard:latest
    ports:
      - "8080:80"
    environment:
      - SOPHON_GATEWAY_URL=http://sophon-gateway:8080
    depends_on:
      - sophon-gateway
    restart: unless-stopped

# Set your data directory (absolute path, forward slashes on Windows)
export SOPHON_DATA=~/.sophon
docker compose up -d

For the full deployment guide with all three tiers and platform-specific instructions, see Docker Deployment.

Native .NET Installation

dotnet tool install -g sophon-cli
sophon start

CLI Installation

dotnet tool install -g sophon-cli
sophon onboard  # Interactive setup wizard

Next Steps

Once installed, proceed to Configuration to add your first LLM provider.