Binary

Run Stib directly on your machine as a native binary — no Docker, no containers. This gives you maximum performance, direct control over the server process, and the simplest possible setup.

Prerequisites

Platform	Architecture	Minimum Version
macOS	ARM64 (Apple Silicon) only	macOS 11.0 (Big Sur)
Linux	x64, ARM64	Any modern distribution
Windows	x64, x86, ARM64	Windows 10+

WARNING

macOS Intel (x86_64) is not supported. There is no pre-compiled binary for Intel-based Macs. Only Apple Silicon (M1/M2/M3/M4) is supported.

TIP

Not sure which installation method to use? Binary is ideal when you want to run Stib directly without containers. For containerized deployments, see Docker or Docker Compose.

Download

Download the latest release for your platform from the download page.

Platform	Architecture	Artifact
macOS	ARM64 (Apple Silicon)	stib-server-macos-arm64.dmg
Linux	x64	stib-server-linux-x64.deb / stib-server-linux-x64.tar.gz
Linux	ARM64	stib-server-linux-arm64.deb / stib-server-linux-arm64.tar.gz
Windows	x64	stib-server-windows-x64.msi
Windows	x86	stib-server-windows-x86.msi
Windows	ARM64	stib-server-windows-arm64.msi

macOS Installation

1. Download stib-server-macos-arm64.dmg
2. Open the DMG and drag stib-server to your Applications folder
3. Launch the app from Applications or run from the terminal:

open /Applications/stib-server.app

WARNING

On first launch, macOS Gatekeeper may block the app because it is not Apple-notarized yet. To allow it:

• Right-click the app → Open, then click Open in the dialog
• Or go to System Settings → Privacy & Security and click Open Anyway

TIP

A system tray icon appears automatically when Stib is running, giving you quick access to server status, logs, restart, and quit options.

Linux Installation

Option 1 — .deb Package (Debian/Ubuntu)

sudo dpkg -i stib-server-linux-x64.deb

The binary is installed to /usr/bin/stib-server.

Option 2 — Manual Installation (any distribution)

tar xzf stib-server-linux-x64.tar.gz
sudo cp stib-server /usr/local/bin/
sudo chmod +x /usr/local/bin/stib-server

INFO

For ARM64 systems, use the arm64 variants of the packages: stib-server-linux-arm64.deb or stib-server-linux-arm64.tar.gz.

Windows Installation

1. Download stib-server-windows-x64.msi (or the x86/ARM64 variant)
2. Run the MSI installer — it installs to Program Files\stib-server\, adds Stib to your system PATH, and creates a Start Menu shortcut

WARNING

On first launch, Windows SmartScreen may show a warning because the binary is not code-signed yet. Click More info → Run anyway to proceed.

Running the Server

Start the server from a terminal:

macOS

# If installed via DMG
open /Applications/stib-server.app

# Or run the binary directly
/Applications/stib-server.app/Contents/MacOS/stib-server

Linux

stib-server

Windows (CMD)

stib-server

The server binds to 0.0.0.0:50505 and creates a data/ directory automatically in the working directory. The web UI is available at http://localhost:50505.

TIP

A system tray icon appears automatically on macOS, Windows, and Linux (with a display server), providing quick access to server status, logs, restart, and quit options.

Environment Variables

Variable	Description	Default	Required
STIB_ENCRYPTION_KEY	Credential encryption key (AES-256-GCM, hex-encoded 32 bytes)	—	Only if using encrypted credentials
STIB_SERVER_ORIGIN	Base URL for OIDC redirects (e.g., https://stib.example.com)	http://localhost:50505	Only for OIDC SSO
STIB_UPDATE_URL	Update checker endpoint	—	Optional
RUST_LOG	Logging level (info, debug, warn)	info	Optional

To generate a valid encryption key:

openssl rand -hex 32

Persistent Data

Stib stores all its data in a data/ directory relative to where the server is running:

data/
├── stib.db          # SQLite database (auto-created)
├── logs/            # Rolling daily logs (7 files max)
├── backups/         # Database backups
└── attachments/     # Card attachments

Run as a Service

Linux — systemd

The tar.gz archive includes a stib-server.service file. To set up automatic startup:

sudo cp stib-server.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now stib-server

Manage the service:

sudo systemctl status stib-server    # Check status
sudo systemctl restart stib-server   # Restart
sudo systemctl stop stib-server      # Stop
journalctl -u stib-server -f         # View logs

macOS — launchd

First, symlink the binary to a fixed location so launchd can find it:

sudo mkdir -p /usr/local/bin
sudo ln -sf /Applications/stib-server.app/Contents/MacOS/stib-server /usr/local/bin/stib-server

Create the LaunchAgent plist at ~/Library/LaunchAgents/com.stib.server.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.stib.server</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/stib-server</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/tmp/stib-server.out.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/stib-server.err.log</string>
    <key>EnvironmentVariables</key>
    <dict>
        <key>RUST_LOG</key>
        <string>info</string>
    </dict>
</dict>
</plist>

Load and start the service:

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.stib.server.plist
launchctl kickstart -k gui/$(id -u)/com.stib.server

To stop and unload:

launchctl bootout gui/$(id -u)/com.stib.server

Verify Installation

Check that Stib is running:

curl http://localhost:50505/api/health

Expected response:

{"data":{"status":"ok"}}

Then open http://localhost:50505 in your browser to access the web UI.

Updating

1. Download the new binary or installer for your platform
2. Stop the running server (systemctl stop stib-server, launchctl bootout gui/$(id -u)/com.stib.server, or Ctrl+C)
3. Replace the binary (or run the new installer)
4. Start the server again — database migrations run automatically

TIP

Your data is safe — the SQLite database and all files in data/ are preserved across updates. For extra safety, back up data/stib.db before updating.

Next Steps

TIP

Head to the Configuration guide to set up your admin account, configure OIDC authentication, and customize your instance.