5tratumOS

5tratumOS is the host platform, WebUI, update surface, and install media for running the 5tratum/AxeSuite app family on dedicated hardware.

License (READ THIS FIRST)

This project is licensed under the Business Source License 1.1 (BSL 1.1). It is NOT an open source license.

• No resale / no preinstalled devices / no "built nodes" without a commercial license: COMMERCIAL_LICENSE.md
• Forks/derivatives are NOT welcome for redistribution: see LICENSE_POLICY.md
• License: LICENSE
• Licensing policy summary: LICENSE_POLICY.md
• Trademark/branding policy: TRADEMARK.md

Downloads

Fresh install: full bootable images

The current complete BETA media release is v0.5.00. These are the files to use for a new machine:

• AMD/Intel UEFI ISO: https://github.com/WillItMod/5tratum/releases/download/v0.5.00/5tratumos-installer-v0.5.00-uefi.iso
• UEFI checksum: https://github.com/WillItMod/5tratum/releases/download/v0.5.00/5tratumos-installer-v0.5.00-uefi.iso.sha256
• AMD/Intel legacy BIOS ISO: https://github.com/WillItMod/5tratum/releases/download/v0.5.00/5tratumos-installer-v0.5.00-bios.iso
• Legacy BIOS checksum: https://github.com/WillItMod/5tratum/releases/download/v0.5.00/5tratumos-installer-v0.5.00-bios.iso.sha256
• Raspberry Pi 4/5 arm64 image: https://github.com/WillItMod/5tratum/releases/download/v0.5.00/5tratumos-raspios-lite-v0.5.00.img.xz
• Raspberry Pi checksum: https://github.com/WillItMod/5tratum/releases/download/v0.5.00/5tratumos-raspios-lite-v0.5.00.img.xz.sha256

Full media release page: https://github.com/WillItMod/5tratum/releases/tag/v0.5.00

Existing installation: update in the WebUI

After first boot, use Settings -> Updates, select the main channel and update to v0.6.1.

• Current update release: https://github.com/WillItMod/5tratum/releases/tag/v0.6.1
• Existing-install updater: 5tratumos-update-v0.6.1.tgz

The .tgz file is deliberately not presented as a fresh-install download. It is an updater payload for an already running 5tratumOS system.

Version v0.6.0 introduced the native 5tratMux control surface and its independently signed updater. 5tratMux ships architecture-specific AMD64 and ARM64 runtimes; installing or updating it does not start its 24-hour trial. The trial begins only when the user explicitly activates it inside 5tratMux. Version v0.6.1 repairs the first-run bootstrap path used by normal WebUI updates and adds continuous service-health supervision.

Full release history: https://github.com/WillItMod/5tratum/releases

Related Projects

5tratumOS is the host platform and update surface. The app family and store matrix live alongside it:

• Axe app hub: https://github.com/WillItMod/AxeSuite
• Umbrel main store: https://github.com/WillItMod/umbrel-community-store
• Umbrel dev store: https://github.com/WillItMod/umbrel-dev-community-store

For the current app matrix, store coverage, and release/changelog pointers, see the AxeSuite docs.

Requirements

• x86 CPU: 64-bit AMD/Intel processor. UEFI is recommended; legacy BIOS/CSM media is available for older systems.
• x86 RAM: 16GB minimum. 32GB+ is recommended if you run multiple full-node apps.
• x86 storage: SSD/NVMe strongly recommended. 1TB minimum for serious use; 2TB+ recommended for multiple chains/apps.
• Raspberry Pi: Raspberry Pi 4/5, 64-bit arm64. 8GB RAM is recommended.
• Raspberry Pi storage: 64GB microSD/SSD minimum for the OS; external SSD/NVMe is recommended for app data and chain storage.
• Network: Wired Ethernet is strongly recommended for mining/node workloads.
• Installer USB: 2GB+ USB drive for ISO installs.

Actual app requirements vary by chain and workload. Full nodes and multi-app fleets need more RAM, disk, and sustained cooling than a basic dashboard-only test install.

Flashing / Install

• Full install guide: docs/install/README.md
• Firmware (BIOS/UEFI/Secure Boot) prerequisites: docs/install/FIRMWARE.md
• Install/boot troubleshooting (common problems): docs/install/TROUBLESHOOTING.md
• Model-specific BIOS/UEFI guides: docs/hardware/README.md
• Verify downloads: docs/install/VERIFY.md
• Raspberry Pi: docs/rpi/README.md

First login / finding your IP

• WebUI credentials are created on first login (there is no default admin password).
• Find the device on your LAN:
  • The IP is shown in the top bar of the WebUI once it loads.
  • Router/DHCP list: look for hostname 5tratumos.
  • mDNS: try http://5tratumos.local/
  • Local console on x86 installs: press Ctrl+Alt+F1 and run ip a
• SSH on x86 ISO installs:
  • Username: forge
  • Password: 5tratum
• SSH on Raspberry Pi images:
  • Create/enable the SSH user in Raspberry Pi Imager OS Customisation before flashing, or use a local keyboard/monitor.

Local Console (Kiosk) on physical hardware

5tratumOS can run a fullscreen local UI (kiosk) on an attached monitor/keyboard.

Important:

• Virtual terminal switching only works on the physical device (attached monitor + keyboard).
• You cannot switch TTYs from a web browser. For remote access, use the WebUI/SSH instead.

If you boot and only see a text login prompt (tty1):

• The kiosk UI runs on tty7.
• On current versions, the system will usually switch to the kiosk UI automatically once it starts.
• tty1 also shows a banner with these shortcuts (useful if kiosk fails to start).
• Press Ctrl+Alt+F7 to switch to the kiosk UI (sometimes Fn+Ctrl+Alt+F7 on compact keyboards/laptops).
• If you try Ctrl+Shift+F7, it will not switch TTYs.
• To go back to the text console, press Ctrl+Alt+F1.

Windows (Rufus) (recommended)

Rufus is the most reliable way to create a bootable 5tratumOS USB installer on Windows.

1. Download 5tratumos-installer-<version>-uefi.iso or 5tratumos-installer-<version>-bios.iso (from the release assets)
2. Download and run Rufus (Windows): https://rufus.ie
3. In Rufus:
   • Device: select your USB drive
   • Boot selection: select the ISO you downloaded
   • Partition scheme:
     • UEFI ISO: GPT
     • BIOS ISO: MBR
4. Click Start (this will erase the USB drive)
5. Boot the target machine from the USB drive and follow the installer prompts

If Rufus asks whether to write in ISO Image mode or DD Image mode, choose DD Image mode.

Windows (Win32 Disk Imager / "WinImager")

1. Open Win32 Disk Imager
2. Select 5tratumos-installer-<version>-uefi.iso or 5tratumos-installer-<version>-bios.iso (you may need to choose ". / All files")
3. Select the correct USB drive letter -> Write
4. Boot the target machine from the USB drive and follow the installer prompts