Binary Install

One-Line Install

curl -fsSL https://particledb.ai/install.sh | bash

This detects your platform and downloads the pre-built binary to /usr/local/bin/particledb.

Supported Platforms

Platform	Architecture	Binary
macOS	Apple Silicon (M1-M4)	particledb-darwin-arm64
macOS	Intel (x86_64)	particledb-darwin-x86_64
Linux	x86_64 (AMD/Intel)	particledb-linux-x86_64
Linux	ARM64 (Graviton/ARM)	particledb-linux-arm64

Manual Download

# macOS Apple Silicon
curl -fSL https://pdb-releases-193278869920-us-east-1.s3.us-east-1.amazonaws.com/latest/particledb-darwin-arm64 -o particledb
chmod +x particledb && sudo mv particledb /usr/local/bin/

# Linux x86_64
curl -fSL https://pdb-releases-193278869920-us-east-1.s3.us-east-1.amazonaws.com/latest/particledb-linux-x86_64 -o particledb
chmod +x particledb && sudo mv particledb /usr/local/bin/

# Linux ARM64 (Graviton)
curl -fSL https://pdb-releases-193278869920-us-east-1.s3.us-east-1.amazonaws.com/latest/particledb-linux-arm64 -o particledb
chmod +x particledb && sudo mv particledb /usr/local/bin/

Start the Server

particledb start

With custom options:

particledb start \
  --data-dir /var/lib/particledb \
  --pg-addr 0.0.0.0:5432 \
  --pg-unix-socket /tmp/.s.PGSQL.5432 \
  --http-addr 0.0.0.0:8080 \
  --wal-sync-mode groupsync

Platform Support

Platform	Architecture	Status
Linux	x86_64	Supported
Linux	aarch64 (Graviton, ARM)	Supported
macOS	Apple Silicon (M1/M2/M3/M4)	Supported
macOS	Intel	Supported
Windows	x86_64	Via WSL2

Systemd Service

[Unit]
Description=ParticleDB
After=network.target

[Service]
Type=simple
User=particledb
ExecStart=/usr/local/bin/particledb start --data-dir /var/lib/particledb
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Save to /etc/systemd/system/particledb.service, then:

sudo systemctl enable particledb
sudo systemctl start particledb