Run OpenCut Web App Without Docker

OpenCut’s Docker stack (Postgres + Redis) is optional while you build UI features.

Minimal .env.local

cp apps/web/.env.example apps/web/.env.local

Edit the file:

DATABASE_URL="file:./dev.db"
UPSTASH_REDIS_REST_URL=""
UPSTASH_REDIS_REST_TOKEN=""
DISABLE_BACKGROUND_WORKERS=true

Install dependencies and run:

cd apps/web
bun install
bun dev

Using SQLite

bun run db:generate
bun run db:migrate

The Drizzle schema will create dev.db inside apps/web.

Feature flags

• Disable transcription queue UI while Redis is absent.
• Mock analytics providers by toggling NEXT_PUBLIC_ENABLE_ANALYTICS=false.

Diagram

  flowchart TD
    A[bun dev] --> B[Next.js server]
    B --> C[SQLite file]
    B --> D[Optional background workers]

When you need cloud parity (background removal, transcription queues), re-enable docker-compose up -d.