W3BS OS · SPECIFICATION
An OS people
and agents can run.
A lightweight Alpine Linux-based operating system with Hyprland (or KDE Plasma, GNOME), zsh, a full setup wizard and every Profullstack app installed, plus a desktop agents can operate under your control. Docker images are the first release; the hardware installer and phone builds follow.
INSTALL
Where it runs today.
DOCKER · AVAILABLERun it in a container.
The server image is Alpine with zsh and the w3bs CLI. The desktop image adds KDE Plasma and the Agentic Desktop Layer, with agent access off until you turn it on.
docker run -it --rm w3bs.org/os:server
sudo modprobe vkms # a virtual display, no GPU needed
docker run -d --name w3bs-desktop --restart unless-stopped \
-v /dev/dri:/dev/dri --device-cgroup-rule 'c 226:* rwm' --group-add video \
--shm-size 512m -e W3BS_VNC_PASSWORD=change-me -p 5900:5900 w3bs.org/os:desktop
Then connect a VNC viewer to port 5900. The container finds the vkms card itself, and binding /dev/dri (not one cardN) keeps it starting after a reboot renumbers the cards. All options.
PCS, INTEL MACS AND VPS SERVERS · ISO 0.1.1.6One installer ISO for x86-64.
The same ISO installs on Intel and AMD PCs, Intel Macs and VPS servers. Boot it with Secure Boot off and run w3bs-os-install: KDE, zsh, encrypted disk and the desktop layer by default, with one review screen before anything is written. Packages download during the install.
Download the ISO (413 MB)
SHA-256 940d69a64a6adf98304b4b63234b584a89cbaaf51079b59ce3e973d50761e87d
curl -fLO https://github.com/profullstack/w3bs.org/releases/download/os-v0.1.1.6/w3bs-os-0.1.1.6-x86_64.iso
curl -fLO https://github.com/profullstack/w3bs.org/releases/download/os-v0.1.1.6/SHA256SUMS && sha256sum -c SHA256SUMS
PC or Intel Mac: write it to a USB stick and boot from it.
sudo dd if=w3bs-os-0.1.1.6-x86_64.iso of=/dev/sdX bs=4M status=progress oflag=sync
VPS: Upload the ISO in your provider’s panel (on netcup: Media › DVD drive, upload by FTP, pick it under Own DVDs and turn on DVD boot), boot the server from it, open the provider’s web console and run w3bs-os-install. KVM servers with virtio disks, BIOS or UEFI, are what we test on.
APPLE SILICON MACS (M1, M2) · COMINGNot from the ISO.
Apple Silicon Macs are ARM and never boot an ISO: Linux goes on them through the Asahi Linux installer, run from macOS, which sets up dual boot. W3BS OS for M1 and M2 will install that way, on the Asahi kernel; M3 follows Asahi's support.
ANDROID PHONES AND TABLETS · AVAILABLEInstall on a phone.
Install Nura (postmarketOS) with Plasma Mobile on a supported, unlockable device, then add W3BS. Unlocking the bootloader erases the phone. A W3BS-branded phone image follows.
curl -fsSL https://w3bs.org/install.sh | sh
w3bs install agentic-desktop-layer
The same two commands work on any Alpine Linux machine. Tested on Alpine 3.24 (x86_64 and ARM64); not yet on a phone. The desktop layer prints the apk add line for anything Plasma Mobile is missing.
IPHONE AND IPADNot as an operating system.
Stock iPhones and iPads only boot software Apple signs, so nothing can replace iOS. They will get the W3BS companion app and remote access to your other devices.
W3BS STUDIO · COMING
Debug desktop and phone apps in one place.
An open-source Xcode for every platform: build, run and debug your app on Android emulators and devices, iOS simulators and iPhones (through your own Mac), Windows, KDE and GNOME, from one target picker, with agents able to run the same builds and tests over MCP. Read §19 of the spec.
INCLUDED SOFTWARE
The whole suite, offline.
The draft suite manifest resolves 65 Profullstack packages from the catalog, including all 12 named inclusions (MoshCode, PairUX, DiskPush, the Agentic Desktop Layer, Training and more). 206 packaging tasks block M0: 65 packages install only through publisher scripts and need signed artifacts, 0 has no pinned release, and 2 command names have two claimants.
APPS FROM OTHER PLATFORMS
One launcher, honest labels.
w3bs run picks the best route for each app and labels its window, so a remote or guest app is never passed off as local.
HARDWARE
Certified, preview, research, unsupported.
Only certified devices get an install button. A device with no supported image is offered the companion app instead.
ALSO IN THE SPEC
For publishers and developers.
W3BS Publish: ship one signed release and reach users on every OS, with deb, Flatpak, Homebrew, winget, MSIX, dmg and APK built from it. Providers: w3bs install drives apt, dnf, pacman, Homebrew, winget, Flatpak, Nix and the app stores, and records what it installed. W3BS Fleet: one desktop app and cloud app for every server, desktop, laptop and phone you own (spec).
Status: specification. Docker editions are out; the installer ISO and phone builds are in testing. Links and supported-hardware results appear here only once those artifacts and checks exist.
w3bs