This is the canonical installation overview. Pick one verified method and follow its guide — the commands below point there rather than duplicating them.
Methods#
| Method | Guide |
|---|---|
Native prebuilt binaries (macOS .dmg, Windows .exe/.zip, Linux .deb/.rpm/.tar.gz) |
Native binaries |
Shell installer for macOS/Linux (install.sh, checksum-enforced) |
Shell installer |
| Docker (binary-only runtime image) | Docker |
| Build from source (pinned Rust toolchain) | Build from source |
| Offline / air-gapped (pre-staged artifacts) | Offline install |
Full comparison with status and evidence: Choose an installation method.
Minimum to verify any method#
plomid-server --version
plomid-server --data ./data --host 127.0.0.1 --port 5432 \
--username plomid --password "$PLOMID_PASSWORD"
psql "postgresql://plomid:$PLOMID_PASSWORD@localhost:5432/plomid" -c "SELECT version();"Flag names: --data (not --data-dir), --username (not --user). If plomid-server is not on PATH after a source build, it is at ./target/release/plomid-server (or ./target/debug/plomid-server).
What is not supported#
No Compose file ships (the docker run invocation is the verified container path). No Kubernetes manifests, Helm charts, or hosted package repositories exist for v0.1.0. Anything claiming otherwise is wrong — see the Support matrix.
Troubleshooting#
| Symptom | Fix |
|---|---|
| Port in use | Change --port / PLOMID_PORT. |
| Non-loopback bind refused | Expected without TLS — pass the explicit opt-in on trusted networks only, or enable TLS. See Run the server. |
| No releases listed | Fresh beta tags may have no published artifacts yet — check the releases page. |
Next: Quickstart.