Server Setup & Downloads

Install SnapHaven Server

SnapHaven Server runs on your computer or NAS. Choose your operating system below to download or view terminal setup commands.

Windows 10 / 11 Setup

Official Store Release

Install SnapHaven Server directly from the Microsoft Store for automated updates and silent background operation, or use the Windows Package Manager (winget).

Option A: Microsoft Store (Recommended) Easiest

Certified and verified by Microsoft. Includes automatic background updates and isolated containerized security.

Option B: Windows Package Manager (winget)

Install in one step from PowerShell or Windows Terminal:

winget install "SnapHaven Server"

💡 Alternatively by Store Product ID: winget install 9N6T9F73803J

Option C: Standalone Installer (.exe)

Prefer a classic setup without the Microsoft Store? Download the standalone installer:

Download SnapHavenInstaller.exe
Quick Setup Guide
1
Launch SnapHaven
Launch SnapHaven Server from the Start menu or system tray. It runs quietly in the background.
2
Web Dashboard Opens
The setup dashboard will open automatically in your browser displaying your pairing QR code.
3
Scan with Mobile App
Open SnapHaven on Android (Get Android Beta on Google Play) and scan the QR code on your monitor to pair securely via mutual TLS.

macOS Setup (Universal App)

Supports both Apple Silicon (M1/M2/M3/M4) and Intel Macs. Download the app bundle below or extract via Terminal.

Download SnapHavenServer-macOS.tar.gz
ℹ️ Safari Note: If Safari automatically decompresses downloads, your file will end with .tar instead of .tar.gz. Both extract identically: double-click the archive in Finder to extract SnapHaven Server.app.
Option A: Graphical Launch (Finder)

Double-click SnapHavenServer-macOS.tar.gz (or .tar) to extract SnapHaven Server.app, then double-click the app to open. If macOS Gatekeeper prevents opening, right-click the app and choose Open, or run xattr -cr "SnapHaven Server.app" in Terminal.

Option B: Terminal Setup
# Extract the archive (.tar.gz or .tar) tar -xzf SnapHavenServer-macOS.tar.gz 2>/dev/null || tar -xf SnapHavenServer-macOS.tar # Clear macOS quarantine flag if needed xattr -cr "SnapHaven Server.app" # Launch the app bundle binary directly ./SnapHaven\ Server.app/Contents/MacOS/snaphaven
🛡️ macOS Firewall & Network Troubleshooting
  • Allow Incoming Connections: When prompted on first launch, click Allow. If pairing fails, navigate to System Settings > Network > Firewall and set SnapHaven to Allow incoming connections.
  • Local Network Permission (macOS 15 Sequoia+): Check System Settings > Privacy & Security > Local Network and ensure the toggle for SnapHaven is enabled.
  • Auto-Start on Boot: To run SnapHaven seamlessly in the background, open the Web Dashboard settings tab and check Launch SnapHaven automatically on system startup.

Linux Installation

Install via Debian/Ubuntu package (`.deb`) or compile directly from Go source.

Debian / Ubuntu (.deb):
wget https://github.com/jonricha/snaphaven-server/releases/latest/download/snaphaven-server_1.0.0_amd64.deb sudo dpkg -i snaphaven-server_1.0.0_amd64.deb sudo systemctl enable --now snaphaven-server snaphaven-server open

💡 Access Dashboard & Pairing QR Code: Click SnapHaven Server in your desktop application grid, open your browser to http://localhost:50005, run snaphaven-server open, or print the pairing QR code directly in your terminal with snaphaven-server qr.

Go Source Installation:
git clone https://github.com/jonricha/snaphaven-server.git cd snaphaven-server/server go run .

Docker & NAS Container Setup

Deploy SnapHaven on Docker, Synology NAS, Unraid, or TrueNAS SCALE.

Docker Compose (docker-compose.yml):
version: '3.8' services: snaphaven: image: ghcr.io/jonricha/snaphaven-server:latest container_name: snaphaven-server restart: unless-stopped ports: - "50005:50005" environment: - HEADLESS=true - SNAP_DIR=/data/photos - SNAP_PORT=:50005 volumes: - /path/to/your/photos:/data/photos - ./config:/config
Docker CLI Run Command:
docker run -d \ --name snaphaven-server \ --restart unless-stopped \ -p 50005:50005 \ -e HEADLESS=true \ -e SNAP_DIR=/data/photos \ -v /path/to/your/photos:/data/photos \ -v ./config:/config \ ghcr.io/jonricha/snaphaven-server:latest
💡 Headless Pairing & Terminal QR Codes
  • Terminal QR Display: View your live pairing QR code right in container logs with docker logs snaphaven-server or via SSH with docker exec -it snaphaven-server snaphaven-server qr.
  • Web Dashboard: Open http://<NAS-IP>:50005 from any computer on your Wi-Fi to view pairing status and manage storage settings.
  • Automatic Port Resilience: If port 50005 is occupied on your host, SnapHaven automatically hunts the next available port and announces it over local mDNS.

📱 Next Step: Scan QR Code & Pair

Once your server is running, open the setup URL displayed in your terminal or browser, open the SnapHaven Android app, and scan the QR code to pair!

Need Firewall Help or Android App Tour? View User Guide →