NornicDB Packaging & Distribution

December 2, 2025 ยท View on GitHub

This directory contains deployment plans for packaging NornicDB as an installable service across all supported platforms.

Supported Platforms

PlatformArchitecturePackage TypeStatus
macOSarm64 (Apple Silicon)Homebrew, .pkg๐Ÿ“‹ Planned
macOSamd64 (Intel)Homebrew, .pkg๐Ÿ“‹ Planned
Windowsamd64MSI + Service๐Ÿ“‹ Planned
Linuxamd64deb, rpm, systemd๐Ÿ“‹ Planned
Linuxarm64deb, rpm, systemd๐Ÿ“‹ Planned
Raspberry Piarm64/armdeb, systemd๐Ÿ“‹ Planned
Dockeramd64, arm64Containerโœ… Available

Quick Cross-Compilation

Build binaries for all platforms from macOS:

cd nornicdb
make cross-all

Output:

bin/nornicdb-linux-amd64    # Linux x86_64
bin/nornicdb-linux-arm64    # Linux ARM64
bin/nornicdb-rpi64          # Raspberry Pi 4/5
bin/nornicdb-rpi32          # Raspberry Pi 2/3
bin/nornicdb-rpi-zero       # Raspberry Pi Zero
bin/nornicdb.exe            # Windows

Distribution Strategy

Developer-Focused

  • Homebrew (macOS) - brew install nornicdb
  • Chocolatey (Windows) - choco install nornicdb
  • Docker Hub - docker pull timothyswt/nornicdb

Enterprise/End-User

  • macOS .pkg - Double-click installer with LaunchDaemon
  • Windows MSI - Standard installer with Windows Service
  • Linux .deb/.rpm - Native package managers

Edge/IoT

  • Raspberry Pi - Optimized ARM builds with systemd
  • NVIDIA Jetson - ARM64 builds (same as linux-arm64)

Directory Structure

packaging/
โ”œโ”€โ”€ README.md                 # This file
โ”œโ”€โ”€ macos.md                  # macOS deployment plan
โ”œโ”€โ”€ windows.md                # Windows deployment plan
โ”œโ”€โ”€ linux.md                  # Linux deployment plan
โ”œโ”€โ”€ raspberry-pi.md           # Raspberry Pi deployment plan
โ””โ”€โ”€ docker.md                 # Docker deployment plan

Implementation Priority

  1. Docker โœ… - Already available
  2. Homebrew - Highest impact for developer adoption
  3. Windows MSI - Required for Windows market
  4. Linux systemd - Server deployments
  5. Raspberry Pi - Edge/IoT market
  6. macOS .pkg - Enterprise macOS users