Browse docs Menu

Start here

Docs home Install Buffaly Install on Windows Install on Linux Install on Mac Quickstart How-to library

Learn Buffaly

What Buffaly is User guide Core concepts Coming from other agents Memory and skills

Build and extend

Add a prompt skill Add a ProtoScript skill Add a C# DLL tool Add a model provider Skills, services, and tools ProtoScript services

Operate

Sessions and long-running work Session anatomy Plan, Scratch, and Tasks Session artifacts Session timeline Compaction

Reference

Ontology and ProtoScript Providers and authentication Web modules and UI Diagnostics & recovery Safety rules Secrets handling SmartPatch

Linux MVP

Install Buffaly on Linux.

Linux support is script-first for the MVP. Install from a GitHub Release tarball, configure external SQL Server, launch with shell scripts, and validate from the terminal.

Download

Download the Linux tarball and checksum from the latest Buffaly installer GitHub Release. Until stable direct asset aliases are published, use the release page.

Open latest release

Install

Linux defaults to no-auth and external SQL Server. Use Linux-specific databases and a Linux-specific SQL login. Do not reuse or alter existing Buffaly SQL logins.

sha256sum -c buffaly-linux-x64-<version>.sha256
tar -xzf buffaly-linux-x64-<version>.tar.gz
cd buffaly-linux-x64-<version>
bash ./scripts/install.sh \
  --install-root "$HOME/buffaly" \
  --port 5088 \
  --auth none \
  --sql-mode external \
  --sessions-connection 'Server=<host>,<port>;Database=buffaly_linux_sessions;User Id=buffaly_linux_app;Password=<password>;TrustServerCertificate=True;' \
  --semantic-connection 'Server=<host>,<port>;Database=buffaly_linux_semanticdb_entities;User Id=buffaly_linux_app;Password=<password>;TrustServerCertificate=True;'

Launch and validate

$HOME/buffaly/buffaly-start.sh
$HOME/buffaly/buffaly-status.sh
$HOME/buffaly/validate.sh --install-root "$HOME/buffaly" --url http://127.0.0.1:5088/ --expect-no-auth
$HOME/buffaly/buffaly-stop.sh

Manual updates

Linux does not yet have the Windows update service. Update manually by stopping Buffaly, backing up config/data, extracting the new tarball, re-running install with the same SQL settings, restarting, and validating.

$HOME/buffaly/buffaly-stop.sh
mkdir -p "$HOME/buffaly-backups"
cp -a "$HOME/buffaly/config" "$HOME/buffaly-backups/config-$(date +%Y%m%d-%H%M%S)"
tar -xzf buffaly-linux-x64-<new-version>.tar.gz
cd buffaly-linux-x64-<new-version>
bash ./scripts/install.sh --install-root "$HOME/buffaly" --port 5088 --auth none --sql-mode external \
  --sessions-connection '<existing sessions connection string>' \
  --semantic-connection '<existing semantic connection string>'
$HOME/buffaly/buffaly-start.sh
$HOME/buffaly/validate.sh --install-root "$HOME/buffaly" --url http://127.0.0.1:5088/ --expect-no-auth

Diagnostics and logs

Integrated diagnostics upload is not available on Linux yet. Collect logs locally and redact secrets before sharing.

mkdir -p "$HOME/buffaly-diagnostics"
$HOME/buffaly/buffaly-status.sh > "$HOME/buffaly-diagnostics/status.txt" 2>&1 || true
$HOME/buffaly/validate.sh --install-root "$HOME/buffaly" --url http://127.0.0.1:5088/ --expect-no-auth > "$HOME/buffaly-diagnostics/validate.txt" 2>&1 || true
tar -czf "$HOME/buffaly-diagnostics/buffaly-diagnostics-$(date +%Y%m%d-%H%M%S).tar.gz" -C "$HOME/buffaly" logs config manifest 2>/dev/null || true

Current Linux MVP limits

No provisioning web UI yet; use scripts.
No native Linux launcher yet; use start/status/stop scripts.
No automatic update service yet; use manual update flow.
No integrated diagnostics upload yet; collect logs manually.
Local SQL Server 2025 on Linux is future gated work; use external SQL Server for MVP.