Installation

Canonical installation overview — compare verified methods and follow one guide.

Version
Latest
v0.1.0 · latest 2 min read
On this page
  1. Methods
  2. Minimum to verify any method
  3. What is not supported
  4. Troubleshooting

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#

shsource
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.

Was this page helpful?