Custom Armbian OS images for Orange Pi 5 and Raspberry Pi 5 with RoSeMAN (blockchain indexer + MongoDB) and sensors.social (sensor map) pre-installed and configured for offline deployment.

• Offline-first: Docker images and SPA are baked into the image — no internet needed after flashing
• Auto-start: All services start on first boot via systemd
• WiFi (RPi 5): Built-in BCM43455, configure via wpa_supplicant.conf on boot partition
• Sensor map: nginx serves sensors.social on port 80, proxies /api/ to RoSeMAN

# 1. Clone this repo
git clone https://github.com/falconexe/SensorsOS.git
cd SensorsOS

# 2. Setup QEMU for arm64 cross-build
docker run --privileged --rm tonistiigi/binfmt --install all

# 3. Sync RoSeMAN source (REQUIRED — not tracked in git)
./sync-roseman.sh

# 4. Build (choose your board)
cd armbian-roseman-map-opi5     # or armbian-roseman-map-rpi5
./prepare-docker-images.sh      # pull Docker images (offline deployment)
./build-map.sh                  # build sensors.social SPA
./build.sh                       # build Armbian image (clones Armbian repo + builds, 30-60 min)

# 5. Flash
xzcat Armbian-*.img.xz | sudo dd of=/dev/sdX bs=4M status=progress
# or use balenaEtcher (supports .xz directly)

• No WiFi on board — use Ethernet
• If boot fails from SD card, run sudo /opt/roseman/scripts/erase-spi-flash.sh

• Built-in WiFi (BCM43455) — place wpa_supplicant.conf on the RPICFG boot partition:

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=US

network={
    ssid="YOUR_WIFI_NAME"
    psk="YOUR_WIFI_PASSWORD"
}

• Hidden networks: add scan_ssid=1 inside network={}
• Open networks: use key_mgmt=NONE instead of psk=
• No config file = WiFi stays off, use Ethernet

SensorsOS/
├── armbian-roseman-map-opi5/          # Orange Pi 5 image
│   ├── build-config/                  # Board config, scripts, .env, systemd
│   ├── overlay/                       # Staging: Docker images, SPA, source
│   ├── build.sh                       # Assembles overlay + runs Armbian build
│   ├── prepare-docker-images.sh       # Pulls Docker images for arm64
│   ├── build-map.sh                   # Builds sensors.social SPA
│   └── README.md
├── armbian-roseman-map-rpi5/          # Raspberry Pi 5 image (same structure)
│   └── ...
├── armbian-build/                     # Armbian build system (git clone, not tracked)
├── sync-roseman.sh                   # Syncs RoSeMAN source from GitHub
├── prepare-docker-images.sh           # Convenience: runs both boards
├── sensors-social-map/build-map.sh    # Convenience: runs both boards
├── LICENSE                            # MIT
└── README.md

When the RoSeMAN Docker image is updated on ghcr.io:

cd SensorsOS

# Sync source code (REQUIRED — not in git)
./sync-roseman.sh

# For each board:
cd armbian-roseman-map-opi5     # or armbian-roseman-map-rpi5
rm -f overlay/opt/roseman/docker-images/*.tar
./prepare-docker-images.sh      # pull new images
./build.sh                      # rebuild Armbian image

MIT for scripts and configs in this repository. Third-party software (Armbian, RoSeMAN, sensors.social, MongoDB) is subject to their respective licenses.