Run it on your own hardware.
One command takes a bare Ubuntu server to a running, hardware-tuned Semurg node. No compiler, no Rust toolchain, no separate Erlang. The engine ships prebuilt and the installer picks the variant that matches your CPU.
Semurg needs Linux on x86_64. Windows (Intel/AMD): the easiest path is
Docker Desktop — it runs the
prebuilt amd64 image natively through WSL2, so there is nothing else to install; or run
wsl --install once and use the Linux lines below inside Ubuntu. Intel
macOS: use the Docker path. Apple Silicon / ARM is not supported (the engine uses AVX
instructions ARM lacks). Your box is ready if uname -m prints
x86_64.
A working database, with real data already in it.
A fresh install comes up holding a real public graph dataset already loaded, so you have
something substantial to query in the first minute instead of an empty store. Then load your own
data through the /v1 API and compare.
A single node is free, self-hosted, with no time limit and no phone-home. It serves on port
4000 and comes up armed: the install prints
ARMED: cold-op self-test PASSED when the fast disk path is live.
What the box needs.
| Requirement | Minimum | Notes |
|---|---|---|
| OS | Ubuntu 24.04 LTS | glibc 2.38+ (24.04 ships 2.39). A 22.04 build is available on request. |
| Arch | x86_64 | Semurg uses AVX-512 where the CPU has it and falls back cleanly where it does not. ARM is not supported today. |
| CPU | 4 cores or more | Shards map to physical cores, so more cores means more parallel arms. |
| RAM | 8 GB or more | Disk is the source of truth; RAM holds a bounded hot subset, never a pinned copy. |
| Disk | 20 GB free or more | NVMe strongly preferred: the read path is deep-queue O_DIRECT. |
One command on a fresh Ubuntu box.
curl -fsSL https://one.semurg.io/install | sudo bash
That downloads the installer, verifies its checksum, and runs it. Seven steps, each printed as it runs: preflight, hardware scan, dependencies, engine and NIF selection, configure, licence, start and verify. It is idempotent, so re-running it is safe, and it fails with a plain-English reason rather than a stack trace.
curl -fsSL https://one.semurg.io/install | less shows exactly what it
does. It creates /etc/semurg and a systemd unit, detects your cores and
disks, and makes no network call except to fetch the bundle from this site.
Load and run, no sudo.
On any x86_64 machine with Docker installed, this downloads a tiny bundle plus the prebuilt image, verifies both, loads the image, and brings up an armed node. Nothing is pulled from a registry and nothing is built on your machine. The compose file already supplies the three container settings the fast disk path needs, so you never type a docker flag.
curl -fsSLO https://one.semurg.io/dl/semurg-docker.tar.gz && curl -fsSLO https://one.semurg.io/dl/semurg-substrate-r11-amd64.tar.gz && curl -fsSL https://one.semurg.io/dl/SHA256SUMS | grep -E ' (semurg-docker\.tar\.gz|semurg-substrate-r11-amd64\.tar\.gz)$' | sha256sum -c - && tar xzf semurg-docker.tar.gz && docker load -i semurg-substrate-r11-amd64.tar.gz && cd semurg-docker && docker compose up
Leave it running and wait for the green line ARMED: cold-op self-test PASSED,
then open http://127.0.0.1:4100. The first run downloads the image (about two minutes);
after that it starts in seconds. No build, no registry pull. If a red SEMURG CANNOT START box appears,
it names the one flag to add and prints the exact command to paste. Flag-by-flag detail is on the
Troubleshooting page.
On Windows (Intel/AMD) or an Intel Mac: install Docker Desktop. On Windows it turns on WSL2 for you the first time it runs (one reboot) — you do not install Ubuntu from the Store or set up a Linux distro by hand. Open the WSL2 (Ubuntu) terminal Docker Desktop provides and paste the command above. The prebuilt amd64 image runs at native speed on any x86_64 Windows PC through WSL2; only Apple Silicon / ARM is unsupported.
Download, verify, then run.
The same three steps the one-command path performs, typed out, if you would rather see each one.
curl -fsSLO https://one.semurg.io/dl/semurg-r11-installer.tar.gz
curl -fsSLO https://one.semurg.io/dl/SHA256SUMS && sha256sum -c SHA256SUMS
tar xzf semurg-r11-installer.tar.gz && cd semurg_installer && sudo ./semurg-install.sh
Step 2 prints semurg-r11-installer.tar.gz: OK. Expected SHA256
d38d5bbc44b099e9e988a72f310a72f6e9b72f1666c47825b440ec23999a56e5
The checksum above is written into this page by the same atomic publish that ships the bundle, so it is the hash of the file you are about to download, never a stale constant. The verify page explains what the checksum does and does not prove.
One archive, eleven languages.
The client SDKs ship with the release and are checksummed in the same SHA256SUMS as the engine installer, rebuilt from the exact commit the engine is built from.
curl -fsSLO https://one.semurg.io/dl/clients.tar.gz && curl -fsSL https://one.semurg.io/dl/SHA256SUMS | grep ' clients.tar.gz$' | sha256sum -c -
Per-language install, a working round-trip, and the honest status of every connection method live on the Drivers page.
A single node is free, with no time limit.
Self-hosted only, anonymous by design, with no phone-home. Multi-node clusters and evaluation licences are signed and issued per evaluator, so we know who is running what and can support you. Tell us what you want to test and we will send the bundle and a 30-day licence.
Email semurg@semurg.org with what you want to evaluate, or read access and roles first to see how a node is protected once it is running.