On this page
Status: Supported for every tagged release. Each release publishes all platforms together with SHA256SUMS.txt.
Prerequisites#
- A tagged release that includes your platform (check the releases page or
sh install.sh --list). - macOS: Apple silicon (
macos-arm64) or Intel (macos-x64). - Windows: x64. Linux: x64 or arm64.
macOS#
- Download the
.dmgfor your architecture from the release page. - Open it and drag PLOMID to Applications.
- First launch of a beta build shows the standard unknown-publisher prompt — right-click → Open to proceed.
Prefer the shell path? See Shell installer (same .tar.gz assets, checksum-verified).
Windows#
- Download the installer
.exeand run it, or download the portable.zip, unpack it, and runplomid.exe. - SmartScreen notes the unknown publisher on beta builds — proceed explicitly.
Linux#
# Debian/Ubuntu (ships a systemd unit):
sudo apt install ./plomid_*.deb
# RPM distros:
sudo rpm -i plomid-*.rpm
# or
sudo dnf install ./plomid-*.rpm
# Any distro (static tarball):
tar xzf plomid-<version>-linux-<arch>.tar.gz
./plomid-server --helpVerify every artifact#
sha256sum -c SHA256SUMS.txt # verify checksums before installing
./plomid-server --versionStart, persist, connect#
plomid-server --data /var/lib/plomid/data --host 127.0.0.1 --port 5432 \
--username plomid --password "$PLOMID_PASSWORD"
psql "postgresql://plomid:$PLOMID_PASSWORD@localhost:5432/plomid"Flag names matter: --data (not --data-dir), --username (not --user). Full reference: Run the server and Configuration. Data persists in the --data directory — back it up per Backup and restore.
Update / uninstall#
- Update: stop the server, take a cold backup, install the new package over the old one, restore to a clean directory with the new binary, and verify. Never skip the backup.
- Uninstall: stop the server, remove the package (
apt remove plomid/rpm -e/ delete the app or directory), and delete the data directory only if you intend to discard the data.
Troubleshooting#
| Symptom | Fix |
|---|---|
| Checksum mismatch | Do not install — re-download; never bypass verification. |
| Unknown-publisher / SmartScreen prompt | Expected for unsigned beta builds; open explicitly. |
| Port 5432 in use | Change --port / PLOMID_PORT. |
| Non-loopback bind refused | Expected without TLS — see Run the server. |
Next: Quickstart.
Was this page helpful? Thanks — noted locally, nothing is sent anywhere.