Skip to content

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)
Terminal window
curl -fsSL https://releases.prism.tm/prism/install.sh | sh

The installer:

  1. detects the OS and architecture (Linux or macOS, amd64 or arm64);
  2. downloads the latest stable release, its SHA256SUMS and the signature of SHA256SUMS from https://releases.prism.tm/prism;
  3. 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 needs ssh-keygen (OpenSSH 8.1 or later, present on macOS and most Linux systems) or OpenSSL;
  4. installs everything for your user, without sudo;
  5. 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;
  6. 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;
  7. 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.

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.

Pass options after sh -s --:

Terminal window
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.

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.

Each release publishes .deb packages for amd64 and arm64 on the release channel. Download and install the one for your architecture:

Terminal window
curl -fsSLO https://releases.prism.tm/prism/v0.30.0/prism_0.30.0_amd64.deb
sudo apt install ./prism_0.30.0_amd64.deb

The package:

  • installs /usr/bin/prism and a system service prism.service, enabled and started;
  • creates the system user prism;
  • writes /etc/prism/config.toml (listens on 127.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.env if it exists (create it with mode 0600);
  • checks the config with prism config check /etc/prism/config.toml before every start. A failed check keeps the service from starting; the reason is in journalctl -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.

Download prism_<version>_<os>_<arch>.tar.gz (Windows: .zip) and SHA256SUMS from https://releases.prism.tm/prism/<version>/, for example:

Terminal window
curl -fsSLO https://releases.prism.tm/prism/v0.30.0/prism_v0.30.0_linux_amd64.tar.gz
curl -fsSLO https://releases.prism.tm/prism/v0.30.0/SHA256SUMS
grep 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.gz
install -m 0755 prism ~/.local/bin/prism
prism version

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

Terminal window
curl -fsS http://127.0.0.1:18000/health # {"status":"ok"}
curl -fsS http://127.0.0.1:18000/v1/models # the models Prism found
prism version

Next: Quick start.