Skip to content

Deployment Overview

Archon can run locally for development or be deployed to a server for always-on operation.

MethodBest ForGuide
LocalDevelopment, personal useLocal Development
DockerSelf-hosted servers, CI environmentsDocker
Cloud VPS24/7 operation with automatic HTTPSCloud Deployment
WindowsNative Windows or WSL2Windows

Using an existing proxy? See Running Archon behind your own reverse proxy for routing, authentication, webhook, and streaming requirements.

OptionSetupBest For
SQLite (default)Zero config, just omit DATABASE_URLSingle-user, CLI usage, local development
Remote PostgreSQLSet DATABASE_URL to hosted DBCloud deployments, shared access
Local PostgreSQLDocker --profile with-dbSelf-hosted, Docker-based setups

SQLite stores data at ~/.archon/archon.db (or /.archon/archon.db in Docker). It is auto-initialized on first run.

GuideAudience
E2E TestingDevelopers and operators
E2E Testing on WSLDevelopers on Windows