Skip to main content

Run the Core

The Core ships as a single Go binary with its web console compiled into it. There is no separate frontend to deploy and no external database to provision.

:::info Early development image The Core image is private and pre-1.0. Authenticate to GitHub Container Registry and use an explicit version tag such as 0.1.0 or 0.1.0-alpha.1. :::

With Docker​

docker login ghcr.io
docker pull ghcr.io/jmarzoli/synapsys-core:0.1.0
docker run -p 8080:8080 -v synapsys-data:/app/data ghcr.io/jmarzoli/synapsys-core:0.1.0

The console is now at http://localhost:8080.

The volume matters: the Core keeps its state in a SQLite database at /app/data/nucleus.db. Without a volume, every worker, process and execution record is lost when the container is replaced.

Checking it is up​

curl http://localhost:8080/api/health

What you have now​

An empty Core. It knows about nothing, because nothing has connected to it yet — workers introduce themselves by heartbeating, not by being registered ahead of time.

Next: your first worker.