Installation Guide

Deploy ClearFox in One Command

All you need is Docker installed on your server.

Run on your server

curl -fsSL https://clearfox.ai/install.sh | sh

This downloads the configuration, pulls Docker images, and starts ClearFox.
Then open http://localhost:3000 to complete the setup wizard.

You'll need

Docker & Docker Compose installed on your server (install guide)
8 GB RAM minimum — full system requirements
License key — buy now or request a demo
AI model API key — Anthropic, OpenAI, or a local model
HTTPS (required for OAuth login with Google/Microsoft) — use a reverse proxy like Caddy or nginx. Details

Updating to a new version

Run the same install command again — it detects the existing installation, updates docker-compose.yml, pulls new images, and restarts. Your .env and data are preserved.

Terminal

curl -fsSL https://clearfox.ai/install.sh | sh

Or manually: cd /opt/clearfox && curl -fsSL -o docker-compose.yml 'https://clearfox.ai/api/install/bundle?type=compose' && docker compose pull && docker compose up -d

Deploy ClearFox in One Command

You'll need

Updating to a new version

Need help?