Installation — Binsight Docs

Binsight is distributed as a single statically-linked binary with zero external dependencies (pure Go, CGO_ENABLED=0). Choose your preferred installation method below.

Homebrew (macOS & Linux)

The recommended installation path for macOS and Linux workstations is via the official Homebrew tap:

Terminal

brew install adrijshikhar/tap/binsight

To upgrade to future releases, run brew update && brew upgrade binsight.

Docker Container

Multi-architecture Docker images (amd64 and arm64) are published automatically to the GitHub Container Registry (GHCR):

Terminal

docker run --rm -p 8080:8080 -v /path/to/binlogs:/binlogs:ro ghcr.io/adrijshikhar/binsight:latest /binlogs

Security Note: Notice the :ro read-only mount flag. Binsight is strictly read-only and never writes to or modifies your binlog files.

One-Line Shell Installer

For CI/CD runners, staging VMs, or quick remote testing without Homebrew:

Terminal

curl -fsSL https://raw.githubusercontent.com/adrijshikhar/binsight/main/install.sh | bash

The script auto-detects your OS and processor architecture, downloads the verified GitHub release archive, checks integrity, and installs the binary to /usr/local/bin/binsight (or ~/.local/bin).

Pre-built Tarball Archives

Standalone tarballs with SHA-256 checksums are available on the GitHub Releases page for:

binsight_Linux_x86_64.tar.gz
binsight_Linux_arm64.tar.gz
binsight_Darwin_x86_64.tar.gz (macOS Intel)
binsight_Darwin_arm64.tar.gz (macOS Apple Silicon M-series)

Compile from Source (Go 1.24+)

If you have Go 1.24 or later installed on your machine:

Terminal

go install github.com/adrijshikhar/binsight/cmd/binsight@latest

Verifying Installation

Confirm that the binary is installed correctly in your shell $PATH:

Terminal

$ binsight version binsight v0.2.1 (built with go1.24)