Install Prism
Prism is one binary. Pick the method that fits the machine:
| Method | Platforms | Runs as | Updates |
|---|---|---|---|
| One-command installer | Linux, macOS (amd64, arm64) | your user, no root | console or prism update |
| Debian package | Linux amd64, arm64 | system user prism |
a newer .deb |
| Release archive | Linux, macOS, Windows | what you set up | console or prism update (not on Windows) |
One-command installer
Section titled “One-command installer”curl -fsSL https://releases.prism.tm/prism/install.sh | shThe installer:
- detects the OS and architecture (Linux or macOS, amd64 or arm64);
- downloads the latest stable release, its
SHA256SUMSand the signature ofSHA256SUMSfromhttps://releases.prism.tm/prism; - checks the signature against the Prism release key built into the script,
then checks the archive against
SHA256SUMS. An unsigned release, a signature by another key or a checksum mismatch stops the installer and nothing is installed. The check needsssh-keygen(OpenSSH 8.1 or later, present on macOS and most Linux systems) or OpenSSL; - installs everything for your user, without
sudo; - asks which providers you use and for their API keys (input is hidden), or
for the address of a local OpenAI-compatible server such as Ollama
(
http://127.0.0.1:11434/v1), which needs no key; - asks whether to send anonymous usage statistics (off unless you agree),
and whether you were invited to a telemetry fleet. Answer
N, the default, unless someone gave you a fleet enrollment; see Fleet telemetry; - writes the config, starts Prism as a user service and checks
http://127.0.0.1:18000/health.
It does not make a paid model call. The check after install uses /health
and /v1/models only.
What goes where
Section titled “What goes where”| Item | Path |
|---|---|
| Binary | ~/.local/bin/prism |
| Config | ~/.prism/config.toml (mode 0600) |
| State (databases, request history) | ~/.prism/data/ |
| Provider keys | ~/.config/prism/prism.env (mode 0600) |
| Console token | ~/.prism/console-token (mode 0600) |
| Service | systemd user unit prism (Linux), launchd agent com.prism.router (macOS) |
| Service logs | journalctl --user -u prism (Linux), ~/Library/Logs/prism/ (macOS) |
The model API listens on 127.0.0.1:18000, the web console on
127.0.0.1:18081.
Installer options
Section titled “Installer options”Pass options after sh -s --:
curl -fsSL https://releases.prism.tm/prism/install.sh | sh -s -- --non-interactive --providers none| Option | Effect |
|---|---|
--version v0.30.0 |
install this release instead of the latest stable one |
--port 18000, --console-port 18081 |
listen ports; they must differ |
--providers openai,anthropic |
providers to set up: openai, anthropic, google, openrouter, groq, deepseek, or none |
--local-url http://127.0.0.1:11434/v1 |
add a keyless local OpenAI-compatible server |
--onepassword |
store 1Password references (op://…) instead of keys |
--statistics-yes |
send anonymous usage statistics |
--service auto|systemd|launchd|none, --no-start |
how to run Prism |
--prefix DIR |
install under DIR instead of your home directory |
--non-interactive |
no questions; with it, keys come from OPENAI_API_KEY and the other provider variables in the environment |
--force-overwrite |
replace an existing config, key file and console token (timestamped .bak copies are written first) |
--dry-run |
print the plan and change nothing |
--paid-smoke |
after install, send one real chat request (this can cost money) |
--no-report |
never send the install signal (below) |
Without --force-overwrite the installer refuses to touch an existing
install.
Install links from prism.tm
Section titled “Install links from prism.tm”The download page on prism.tm gives a command of the form
curl -fsSL "https://prism.tm/install.sh?t=…" | sh. It installs the same
release the same way. The only difference is an anonymous install token
that comes from the site. With a token, the installer sends one record when
it finishes: install_succeeded, or install_failed with the stage that
failed. The record holds the token, the event, the Prism version, OS,
architecture and install mode, and nothing else. The installer says so
before it downloads anything. --no-report or PRISM_NO_REPORT=1 turns it
off. Without a token nothing is sent. See
Install signal.
Debian package
Section titled “Debian package”Each release publishes .deb packages for amd64 and arm64 on the release
channel. Download and install the one for your architecture:
curl -fsSLO https://releases.prism.tm/prism/v0.30.0/prism_0.30.0_amd64.debsudo apt install ./prism_0.30.0_amd64.debThe package:
- installs
/usr/bin/prismand a system serviceprism.service, enabled and started; - creates the system user
prism; - writes
/etc/prism/config.toml(listens on127.0.0.1:18000, state in/var/lib/prism); apt keeps your edits to this file on upgrade; - reads provider keys from
/etc/prism/prism.envif it exists (create it with mode 0600); - checks the config with
prism config check /etc/prism/config.tomlbefore every start. A failed check keeps the service from starting; the reason is injournalctl -u prism.
The console and prism update do not update a packaged Prism: they show new
releases and point to the package. To update, install the newer .deb the
same way. Before a package upgrade restarts Prism, the new version checks the
config; if the check fails, the running Prism keeps serving and apt reports
the package as not configured. Fix the config and run
sudo dpkg --configure -a.
Release archive
Section titled “Release archive”Download prism_<version>_<os>_<arch>.tar.gz (Windows: .zip) and
SHA256SUMS from https://releases.prism.tm/prism/<version>/, for example:
curl -fsSLO https://releases.prism.tm/prism/v0.30.0/prism_v0.30.0_linux_amd64.tar.gzcurl -fsSLO https://releases.prism.tm/prism/v0.30.0/SHA256SUMSgrep prism_v0.30.0_linux_amd64.tar.gz SHA256SUMS | sha256sum -c - # macOS: shasum -a 256 -c -tar -xzf prism_v0.30.0_linux_amd64.tar.gzinstall -m 0755 prism ~/.local/bin/prismprism versionOn macOS, if Gatekeeper blocks a binary downloaded with a browser, remove the
quarantine attribute: xattr -d com.apple.quarantine ~/.local/bin/prism.
prism serve reads config.toml from its working directory (or the path
given with --config) and keeps state in [storage] dir, ./data by
default. An empty config.toml is a valid config. To run the binary as a
service, see Run as a service.
Windows has no installer and no service setup; run prism.exe serve by hand.
Check that it works
Section titled “Check that it works”curl -fsS http://127.0.0.1:18000/health # {"status":"ok"}curl -fsS http://127.0.0.1:18000/v1/models # the models Prism foundprism versionNext: Quick start.