Cloud-like experience on your own hardware. No monthly bills.
This repository contains the full source code and build for Reefy OS.
Reefy OS isn't another shell on top of Ubuntu or Debian with a web UI bolted on. We started from Buildroot and hand-picked every package from the kernel up: 15-second cold boot, Nvidia GPU as a first-class citizen, immutable A/B root with auto-rollback, encryption keyed to a USB dongle, and no package manager on the device so the system never drifts. The app catalog is AI-focused from day one - AI agents (OpenClaw, Hermes), local LLM inference (Ollama, vLLM, SGLang), vision pipelines - not retrofitted onto a general-purpose distro. Legacy distros weren't designed to boot fast, run GPU workloads natively, survive bad updates in remote closets, and keep your data on your side of the wire. Reefy OS was.
Security by design. Reefy OS is built around a minimal host, immutable A/B firmware, a Linux LTS kernel, encrypted storage, containerized applications, and publicly traceable builds. Read the Reefy OS Security Model →
Secure tunnels to every device. No port forwarding, no VPN, no static IP needed. Built-in web terminal with on-screen control buttons gives you a real terminal experience even from your phone.
Run multiple OpenClaw and Hermes agents. Spin them up for different tasks, fully isolated.
Don't pay per token - point OpenClaw and Hermes at your flat-rate OpenAI Codex or xAI Grok subscription instead. Reefy hides the OAuth dance: a one-time device-code flow attaches your account, and the agents get a local OPENAI_BASE_URL to talk to. The proxy refreshes access tokens, persists rotated refresh tokens, and handles 401/403 retry transparently - the agents see nothing but the standard OpenAI HTTP API.
The proxy is its own open-source project, MIT-licensed: reefyai/reefy-llm-proxy.
Use at your own risk and have a read of your provider's terms - allowed use varies by plan.
Your apps and data are encrypted and backed up to the cloud. Use Adopt & Clone to restore everything and get back to work in minutes.
Reefy ships with NVIDIA drivers built-in - just start Ollama or any other GPU-aware tool and it works.
A/B firmware with a hardware watchdog: a bad update auto-rolls back to the previous working version. Critical for devices in closets, attics, and other hard-to-reach places.
Why rent a cloud VPS for $10/month when the old PC under your desk can do more - for free? The hardware you already own is more powerful than most people realize. You just need the right software to unlock it.
Why send your private data to someone else's computer? Your conversations with AI, your camera feeds, your documents - they don't need to live on a server you don't control.
We're not replacing the cloud - Reefy uses clouds a lot under the hood. We're moving your personal work closer to you.
Zero-touch setup - Flash a USB, boot any x86 machine, see it on your dashboard in 60 seconds.
15-second boot - We optimized the Linux kernel and early boot services to eliminate ugly waits. From power button to running apps - blazing fast.
Can't brick it - A/B firmware with hardware watchdog. Bad update? Device automatically rolls back to the previous working version. Critical for devices in closets, attics, and remote locations.
Works offline - LAN access to all your apps when internet goes down. Devices issue their own SSL certificates that you can import into your browser for a near-internet experience without real internet. Can run fully air-gapped - think internet on the Moon or Mars when people start building habitats there, or security-sensitive environments with intentionally disconnected networks.
Nvidia GPU support - Latest Nvidia drivers included out of the box. Any Reefy app can access the GPU - run LLMs, AI inference, video processing, or CUDA workloads without driver hassles.
Bare metal performance - Docker containers run directly on x86 hardware. No hypervisor overhead. Every watt and every megabyte goes to your workload - especially important on small, low-power PCs.
Encrypted & portable - Data encrypted on disk with keys on the USB dongle. Pull the USB and the device is a paperweight - safe to give away or sell. Plug the USB into a new PC, restore from backup, and you're back in minutes. Have a spare device? You can achieve 99.9% availability (the cloud gold standard - under 9 hours downtime per year) by switching your workloads to the spare in minutes.
Automated backups - Your apps and data are backed up automatically. Restore to any device with one click. Replace a broken machine without losing anything. Pin a backup with a tag and use it as a baseline to multiply your agents - configure your OpenClaw or Hermes Agent once, then clone it to new devices without repeating the initial setup.
One-click app install - Deploy apps from the catalog or develop your own Reefy apps based on Docker containers. Each app gets its own isolated environment, accessible from anywhere with a secure link.
Old laptop, mini-PC, used NUC, or a high-end server with GPUs.
Log in at reefy.ai with your Google or GitHub account - one click, no signup forms. Then grab your personalized device image from Settings.
Use Balena Etcher - cross-platform, drag the reefy.raw file in, pick your USB, click flash.
Command-line (Linux/macOS, no GUI)
sudo dd if=reefy.raw of=/dev/sdX bs=4M
Plug in the USB, power on, hit Esc or Del to open the boot menu. Pick the USB. Reefy boots in ~15 seconds.
Optional: if boot is blocked
Disable Secure Boot in your BIOS. Common path: Security → Secure Boot → Disabled.
Your device shows up automatically in the Reefy dashboard once it's online. Click Adopt, give it a name. Done.
Ready to turn your PC into a Reef?
Get started at reefy.ai →