KODEOS
Alpha · v0.2.0-alpha · Read the release notes

Your private cloud server in 5 minutes.

KODE OS turns a Raspberry Pi into a calm, private home for your apps, files and photos. No accounts. No telemetry. Just yours.

Download KODE OS v0.2.0-alpha View on GitHub
pebble.local
The KODE OS dashboard — a welcome screen with widgets for time, weather, files, apps, storage and network.
Features

A friendly OS, end to end

KODE OS hides the wiring and surfaces the things people actually do — photos, files, apps, accounts.

A dashboard for the family

Drag-and-drop widgets, six ready-made layouts. Each family member gets their own. Nothing technical to learn.

Set up in five minutes

A guided first-boot wizard walks you through Wi-Fi, accounts and your first apps. No terminal required.

Accounts for everyone

Add a profile for each person in the house. Kids can sign in, parents stay in control, everyone keeps their own space.

Private by default

No accounts to sign up for. No analytics. No phone-home updates. Your pebble stays on your network — and stays yours.

Apps you actually want

Photos, file sharing, movies, smart home, ad-blocking, more. Browse the built-in catalogue and install with one tap.

Open source, end to end

Apache 2.0 licensed. Built on CasaOS. Every line of code lives on GitHub — yours to read, fork or contribute back.

Install

Three steps, one cup of coffee

KODE OS ships as a single image based on Raspberry Pi OS Lite — you flash it once and boot. No terminal, no install script.

  1. 1

    Download the image

    Grab the latest .img.xz from the GitHub release. About 475 MB compressed.

  2. 2

    Flash with Raspberry Pi Imager

    Open Raspberry Pi Imager, pick “Use custom”, choose the .img.xz, and write it to your SD card.

  3. 3

    Boot and open the wizard

    Plug in power and ethernet. After a few minutes, open http://pebble.local/ in any browser on your network.

verify your download (optional) 
# Optional: verify the download before flashing
curl -fLO https://github.com/KodeNAS/kode-os/releases/download/v0.2.0-alpha/kode-os-v0.2.0-alpha-pi5-lite.img.xz.sha256
sha256sum -c kode-os-v0.2.0-alpha-pi5-lite.img.xz.sha256

Tested on Raspberry Pi 5 (4 GB). The 8 GB model is expected to work but is unverified this release. Pi 4 support is on the roadmap — track it on GitHub.

Read the full installation guide
Screenshots

What you'll actually see

A guided tour bubble highlighting the Clock widget on the KODE OS dashboard, explaining how to switch between digital and analog time.

Tours, built in

Each widget and each app comes with a built-in walkthrough — no separate manual to hunt for.

First-boot wizard step asking the user to pick Beginner, Normal or Developer mode.

Pick your style

Beginner mode hides anything technical. Switch later from settings.

First-boot wizard step showing a curated list of apps to install — Immich, Jellyfin, File Browser, Pi-hole and Home Assistant.

Pick your apps

Browse a curated catalogue on first boot. Apps install while you finish setting up.

Two repos

System and surface, split on purpose

The OS underneath and the dashboard on top live in separate repos. Easier to read, easier to ship.

KodeNAS / kode-os Apache 2.0

the system

Installer, OLED display daemon, branding, system services. Run this on a fresh Raspberry Pi 5 and you have a pebble.

Visit on GitHub
KodeNAS / kode-os-ui Apache 2.0

the dashboard

The web dashboard your family signs into. Vue 2 on Bulma + Buefy. Lives in its own repo so we can ship UI updates without re-flashing the SD card.

Visit on GitHub
Built in the open

A homelab project, made gentler.

KODE OS is a fork of CasaOS — the same calm, technical foundation, polished into something a non-technical family member can sign into. Every commit lives on GitHub. Issues and pull requests welcome.

KodeNAS on GitHub Star kode-os Star kode-os-ui