Skip to content

platforms

Jump to bottom
aniongithub edited this page May 19, 2026 · 1 revision

title: Platform compatibility type: guide

Platform compatibility

mind-map runs anywhere Go 1.21+ runs. Releases ship pre-built binaries for the common cases.

Supported platforms

OS Architectures Notes
Linux amd64, arm64 glibc + musl both fine (static binary)
macOS amd64 (Intel), arm64 (Apple Silicon) Unsigned — first-launch warning, see below
Windows amd64, arm64 No installer, just a .exe
FreeBSD / OpenBSD amd64 Not pre-built; go install works
Raspberry Pi arm64 Tested on Pi 4 / Pi 5

Everything is statically linked. No CGO, no shared libs, no glibc version pinning.

Why this matters

  • No package-manager fragmentation. One binary for all distros.
  • No "Linux + extras" RPM/DEB/AUR/PKG dance. Drop the binary; run it.
  • Container-friendly. A FROM scratch image with the binary copied in is ~38 MB total. See design/lightweight.
  • Truly portable. USB-stick portable: copy binary + wiki dir to another machine of the same OS/arch and resume.

Per-OS quirks

Linux

Nothing special. Pre-built binary works on every distro from 2018+. Static linkage means no glibc version issues.

macOS

The release binary is unsigned. First launch: System Preferences → Privacy & Security → "Allow anyway." Or build from source:

git clone https://github.com/aniongithub/mind-map
cd mind-map && go build ./cmd/mind-map

Apple-silicon Macs run both arm64 and amd64 binaries (Rosetta). The native arm64 is faster.

Windows

The pre-built .exe is unsigned. SmartScreen will show "Don't run" on first launch — click More info → Run anyway, or rebuild from source.

mind-map serve opens port 4242 on 127.0.0.1. Windows Firewall may prompt; pick "private networks only" — it never needs public exposure.

For guides/service on Windows, mind-map registers as a Windows Service via the kardianos/service library.

What just-works everywhere

See also

Clone this wiki locally