Skip to main content

Install the Core

The Core is one Go binary with the React console compiled into it via go:embed. One artifact, one port, one file of state.

:::info Not published yet No public image, no tagged release. Built from source until then. :::

Docker​

git clone https://github.com/JMarzoli/synapsys-core-go.git
cd synapsys-core-go
docker build -t synapsys-core .
docker run -p 8080:8080 -v synapsys-data:/app/data synapsys-core

The build is multi-stage: Node builds the frontend, Go embeds it and compiles a static binary, and the runtime image is Alpine with just that binary.

What it needs​

Port8080
StateSQLite at /app/data/nucleus.db
Volume/app/data — required if you want your data to survive
External servicesnone

Networking​

Workers need to reach the Core's /api/v1/workers/heartbeat endpoint outbound. The Core needs to reach nothing.

If you run the console from a separate origin during development, note that the Core's CORS layer allows exactly one origin — http://localhost:5173, the Vite dev server. In production the console is served by the Core itself and CORS does not apply.

Upgrading​

Schema migrations are tracked in a schema_migrations ledger and applied at startup. Migrations that have already been applied are never edited; a change means a new migration. Back up nucleus.db before upgrading anyway.