Self-Hosting
Track 1 - Direct Ingestion
Deploy Vision Community Edition with 1 command using Docker Compose.
The Direct Ingestion Track is the fastest and simplest way to run Vision. It runs the entire stack—PostgreSQL, ClickHouse, the Hono backend API, and the Next.js dashboard—without requiring Kafka or distributed message brokers.
Prerequisites
- Docker Engine (v24.0 or higher)
- Docker Compose (v2.20 or higher)
- A server with at least 2 vCPUs and 4GB RAM (e.g. a $10–$20/mo VPS on Hetzner, DigitalOcean, or AWS EC2).
1. Clone the Repository
git clone https://github.com/abhirupkumar/vision-oss.git vision
cd vision2. Configure Environment Variables
Copy the sample environment file:
cp docker/.env.oss.example .envReview the default .env configuration:
# Application Ports
PORT=3000
BACKEND_PORT=3001
NEXT_PUBLIC_API_URL=http://localhost:3001
NEXT_PUBLIC_IS_CLOUD=false
# PostgreSQL Database
DATABASE_URL=postgresql://vision_user:vision_password@postgres:5432/vision
# ClickHouse Analytics Database
CLICKHOUSE_URL=http://clickhouse:8123
# Direct Ingestion Flag (No Kafka)
KAFKA_PRESENT=false
DISABLE_BOT_CHECK=false3. Start the Cluster
Run Docker Compose in detached mode:
docker compose up -dVerify that all containers are healthy:
docker compose psYou should see 4 active services:
vision-postgres: Port5432(metadata storage)vision-clickhouse: Port8123&9000(time-series analytics)vision-backend: Port3001(telemetry API & LLM proxy)vision-dashboard: Port3000(web console)
4. Access the Dashboard
Open your browser and navigate to:
http://localhost:3000- Create your initial admin account.
- Create your first project.
- Grab your tracking script snippet and add it to your website or web application!
Updating to the Latest Release
To pull the newest updates and rebuild containers:
git pull origin main
docker compose build
docker compose up -d