The Shadow that Powers the Machine
Ultra-minimal deployment Linux. Boot in 2 seconds, SSH ready, deploy static binaries via scp. No package manager, no systemd, no bloat.
Named after Wayang, the ancient Javanese shadow puppet art — WayangOS is the invisible hand that controls your hardware with precision and grace. Like the dalang who commands hundreds of puppets from behind the screen, WayangOS orchestrates your hardware with total control and zero waste.
Every feature is a conscious choice. Every byte earns its place.
20 MB bootable ISO. BusyBox + Dropbear SSH + curl. No systemd, no D-Bus, no polkit. 4 static binaries, zero shared libraries. UEFI + BIOS hybrid boot.
4 binaries · 20 MB · UEFI+BIOS · doneDHCP auto-configures on boot. Dropbear SSH server starts automatically on port 22. curl with TLS for pulling configs and APIs. Manage remotely from day one.
dropbear + curl + udhcpcNo package manager. No dependency hell. Build your app as a static binary, scp it to the machine, run it. That's deployment. If it compiles, it ships.
scp is your pkg manager21 MB ISO with framebuffer rendering. GUI edition boots with display drivers for kiosk apps, digital signage, and dashboards. No X11, no Wayland.
DRM/KMS + FramebufferVendor-specific GPU drivers for Intel (i915), AMD (amdgpu), and NVIDIA (nouveau). ARM SBC support with Raspberry Pi 3 HDMI (VideoCore IV) and Orange Pi Zero 2W HDMI (Mali). Hardware-accelerated graphics out of the box.
Intel · AMD · NVIDIA · RPi3 · OPi Zero 2W4 binaries total. No unnecessary services, no listening ports except SSH. Fewer packages = fewer CVEs. The best security is code that doesn't exist.
fewer packages = fewer CVEsLinux 6.19.3-rt1 with full real-time preemption, 1000Hz tick, and high-res timers. Deterministic scheduling for when microseconds matter. RTOS by default.
CONFIG_PREEMPT_RT=y · 1000Hz · x86_64Numbers don't lie. Less is more.
| Metric | WayangOS | Alpine Linux | Ubuntu Server | Debian Minimal |
|---|---|---|---|---|
| ISO Size | 20 MB | ~200 MB | ~1.2 GB | ~600 MB |
| Min RAM | 64 MB | 128 MB | 512 MB | 256 MB |
| Boot Time | < 2s | ~5s | ~15s | ~8s |
| Init System | Custom (shell) | OpenRC | systemd | systemd |
| SSH on Boot | ✓ Built-in | ✗ Install | ✓ Optional | ✗ Install |
| Package Manager | None (scp) | apk | apt | apt |
| GUI Edition | ✓ fbdev/DRM | ✗ Manual | ✓ Desktop | ✗ Manual |
| Packages | 4 (static) | ~14 (base) | ~300+ (base) | ~150+ (base) |
x86_64 and ARM64 available. RISC-V on the roadmap.
WayangOS is available for Intel, AMD, NVIDIA, Raspberry Pi, and Orange Pi.
v0.6.0 — GPU Support · x86_64 + ARM64 · 17–35 MB
No terminal skills needed. Works on any PC or laptop.
Same steps for both editions — just pick the ISO you want.
Select your GPU/platform and grab the bootable ISO. UEFI + BIOS hybrid — works on any modern or legacy hardware.
⬇ Download SelectedUse any USB flashing tool. Pick your platform:
Open the tool → Select the .iso file → Select your USB → Click Flash. Done.
Plug the USB into your PC/laptop and restart. Press the boot menu key during startup:
Select your USB from the boot menu → WayangOS boots to a shell in <2 seconds.
GRUB menu — auto-boots in 3 seconds
Booted — SSH ready, networking up
Or open the .iso in VirtualBox / VMware — it just works.
Want to customize? Build from source:
🔧 WayangOS SourceWayangOS isn't a toy. Here's where it runs in production.
Turn any old PC or laptop into a headless server. Boot from USB, SSH in, deploy your apps. No GUI waste, no systemd overhead.
Collect sensor data, relay MQTT messages, bridge networks. Runs on 64 MB RAM — works on the cheapest SBCs.
Boot straight into your application. POS terminal, digital signage, monitoring dashboard. No login screen, no desktop environment.
Minimal attack surface = maximum security. Build a custom firewall, VPN gateway, or traffic monitor.
Spin up disposable build environments in seconds. Boot a VM from the ISO, run your build, tear it down.
5 processes at boot vs Ubuntu's 200+. Boots in under 2 seconds, uses 23 MB RAM.
No package manager. No dependency hell. No apt install.
Your "package manager" is scp. Build your app as a static binary. Copy it to the machine. Run it. That's deployment.
Every binary stands alone. No shared libraries, no version conflicts, no "works on my machine." If it compiles, it ships.
Production-ready applications built for WayangOS — starting with WayangPOS, a complete touchscreen point of sale system for small businesses.
Touchscreen · Receipt printing · Stock tracking · Discounts · CSV export · Affordable hardware · No monthly fees