Linux
Keep Debian or Ubuntu underneath and add the complete 5tratumOS operating experience above its Linux kernel.
Install desk
Choose how you run 5tratumOS.
Install it over Linux, create a dedicated Proxmox LXC, add it to an existing Raspberry Pi, or start clean from a complete image.
Install without starting over
Keep the kernel. Add the operating layer.
5tratumOS can run above a supported Linux foundation, inside a dedicated Proxmox LXC, or above Raspberry Pi OS. Choose a route and copy one command.
Proxmox
Run one helper in the Proxmox shell. It creates a Debian guest and installs 5tratumOS inside it—not on the hypervisor.
Raspberry Pi
Keep Raspberry Pi OS Lite on a Pi 4 or 5 and install 5tratumOS above its existing Linux kernel.
AMD64 · EXISTING HOST
Add 5tratumOS to a supported Linux server.
The host keeps its Linux kernel, drivers, networking, storage and system services. The installer adds the 5tratumOS dashboard, app store, updater and container-management services without reformatting the machine.
Back up the host
Use a dedicated machine or VM and protect anything already stored on it.
Run the command
The helper installs required packages, Docker and the signed 5tratumOS bundle.
Open the dashboard
Visit the machine’s IP address in a browser when the installer completes.
Supported Linux hostsDebian 12 (Bookworm)Debian 13 (Trixie)Ubuntu Server 22.04 LTSUbuntu Server 24.04 LTS64-bit AMD / Intel
RUN ON THE LINUX HOST
curl -fsSL https://raw.githubusercontent.com/WillItMod/5tratum/main/scripts/install-linux.sh | sudo env CHANNEL=main bashDEDICATED · UNPRIVILEGED LXC
Create a purpose-built 5tratumOS LXC.
The helper selects the next VMID and suitable storage, downloads the newest Debian 12 or 13 template, creates an unprivileged LXC on vmbr0 with DHCP, and installs 5tratumOS entirely inside that guest.
Open the Proxmox shell
Use the web console or SSH to connect to the Proxmox VE host as root.
Run the helper
The helper uses native Proxmox tools and refuses to reuse an occupied VMID.
Open the guest
Use the printed guest IP to open 5tratumOS. Increase resources for full-node apps.
Default LXCDebian 12 or Debian 13 guestUnprivileged container4 CPU cores · 8 GiB RAM128 GiB root diskvmbr0 · DHCP · on-boot
RUN AS ROOT ON THE PROXMOX VE HOST
curl -fsSL https://raw.githubusercontent.com/WillItMod/5tratum/main/scripts/install-proxmox.sh | bashARM64 · EXISTING HOST
Turn an existing Raspberry Pi into a 5tratumOS host.
Raspberry Pi OS remains responsible for the kernel, board support, networking and storage. 5tratumOS installs above it as the interface and management layer for apps, nodes and miners.
Prepare Raspberry Pi OS
Start from a current 64-bit Lite installation with SSH or local terminal access.
Run the command
The installer adds Docker and the 5tratumOS services above Raspberry Pi OS.
Move app data to SSD
For full nodes, use external SSD or NVMe storage rather than the boot microSD.
Supported Raspberry Pi hostsRaspberry Pi 4 or 5Raspberry Pi OS Lite 64-bit · BookwormRaspberry Pi OS Lite 64-bit · Trixie8 GiB RAM recommendedExternal SSD / NVMe preferred
RUN ON THE RASPBERRY PI
curl -fsSL https://raw.githubusercontent.com/WillItMod/5tratum/main/scripts/install-rpi.sh | sudo env CHANNEL=main INSTALL_TAG=latest bashWhat “on top of Linux” means
5tratumOS is the operating layer above your Linux kernel.
The in-place installer keeps the host's Linux kernel, hardware drivers, networking, storage and system services. 5tratumOS adds its managed services under /opt/5tratumos, installs Docker when needed and becomes the operating and management layer for your nodes, miners and apps.
It does not create a dual-boot system or reformat the host disk. Root access is required, and a backup is still recommended before changing an existing server.
THE LAYER YOU OPERATE5tratumOSDashboard · app store · updates · orchestration
MANAGED WORKLOADSDocker apps, nodes & miners
SUPPORTED HOSTDebian · Ubuntu · Raspberry Pi OS
FOUNDATIONLinux kernel · drivers · hardware
Before you run a one-line installer
Use a dedicated machine or VM, back up anything important and review the official script first. The installer runs as root, installs packages, enables Docker and systemd services, and replaces an earlier 5tratumOS platform installation if one is present. Other Linux distributions may work, but are not listed as supported installation targets.
Start from a complete image
Clean-install media for dedicated hardware.
Use this route when 5tratumOS will own the machine or virtual machine from first boot.
RECOMMENDED
AMD / Intel · UEFI
For modern mini PCs, desktops and servers. Write the UEFI ISO to a USB drive with Rufus, boot it, then follow the installer.
Full image v0.5.00 · update to v0.6.6 after first boot
5tratumos-installer-v0.5.00-uefi.isoGOOD STARTING POINT
- 64-bit x86 CPU
- 16 GB RAM minimum
- 1 TB SSD / NVMe recommended
The newest complete installation media is v0.5.00. After first boot, use the signed in-OS updater to reach the current v0.6.6 release. Update-only .tgz files are deliberately not offered as fresh-install downloads here.
The full-image route
Six steps for a clean image install.
Everything needed when 5tratumOS will own the machine from first boot, with deeper documentation ready when the hardware needs something unusual.
Choose the right image
Modern x86 systems use the UEFI ISO. Older PCs use the BIOS ISO. Raspberry Pi 4 and 5 use the compressed arm64 image. These are full installers, not updater archives.
Verify the download
Download the matching SHA-256 file from GitHub and compare it before writing the installer. A clean checksum means the file arrived intact.
Write the media
On Windows use Rufus in DD mode. For Raspberry Pi use Raspberry Pi Imager. The target USB, microSD or SSD will be erased.
Boot and install
Boot the target machine from the new media, follow the prompts and install onto the SSD or NVMe selected for 5tratumOS.
Open your dashboard
Visit http://5tratumos.local/ or use the IP shown by your router. Create the first WebUI account; there is no default admin password.
Install your apps
Open the Community App Store, choose a node or mining app, then watch its sync and startup checks from one place.
Keep these open