Binary Install

Run mise-server directly as a Rust binary.

Requirements

• PostgreSQL 15+
• S3-compatible storage (AWS S3, MinIO, R2, Tigris, etc.)
• Rust 1.85+ (for building from source)

Install from Source

cargo install --path .

Run

export DATABASE_URL=postgres://localhost/mise_server
export MISE_SERVER_S3_BUCKET=my-bucket
export AWS_ACCESS_KEY_ID=...
export AWS_SECRET_ACCESS_KEY=...
mise-server serve --port 3000

With a Config File

mise-server serve --config /path/to/mise-server.toml

CLI Commands

mise-server serve              # start the proxy server
mise-server gc                 # garbage collect old cache entries
mise-server token generate     # generate a token and its hash

Systemd Service

[Unit]
Description=mise-server
After=network.target postgresql.service

[Service]
ExecStart=/usr/local/bin/mise-server serve
EnvironmentFile=/etc/mise-server/env
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target