Installation
Synkora can be installed in three practical ways:
- Interactive installer for quickest setup
- Docker Compose for explicit local control
- Split local development for hacking on API or web services directly
Hardware Expectations
Synkora is not a tiny demo stack. A normal local environment includes Redis, PostgreSQL, Qdrant, Elasticsearch, ML services, Playwright-based scraping, Langfuse, and multiple workers.
| Minimum | Recommended | |
|---|---|---|
| RAM | 16 GB | 32 GB |
| CPU | 4 cores | 8+ cores |
| Disk | 40 GB | 100 GB |
If you under-size the machine, Elasticsearch and the ML service are the first places you will feel it.
Required Software
- Docker Engine 24+
- Docker Compose v2
openssl
Optional for local development:
- Node.js 20+
- pnpm 8+
- Python 3.11+
uv
Option 1: Installer
Use this when you want the fastest path to a working Synkora environment.
Loading...
Option 2: Docker Compose
Use this when you want to inspect or control the environment yourself.
Loading...
Then run migrations and seed platform data:
Loading...
Option 3: Local Development
Use this when you are contributing to the repo and want faster iteration on specific services.
Backend:
Loading...
Frontend:
Loading...
Choosing the Right Path
- Use the installer for evaluation or first-time setup
- Use Docker Compose for regular local product work
- Use local development mode when actively changing backend or frontend code