Skip to content

About

An intuitive, versatile, and powerful home server operating system for self-hosting. Featuring a curated app store and seamless multi-platform support, it’s designed to empower your personal cloud on Raspberry Pi, x86 systems, or your preferred setup.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

931 stars

Watchers

12 watching

Forks

Latest commit

 

History

184 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HomeDock OS - The Self-hosted Cloud OS to Simplify Your Life

HomeDock OS

Take control of the cloud like never before. 800+ self-hosted apps, a real desktop in your browser, and every file you own a double-click away. Free, private, and running on whatever hardware you already have.


Deploy HomeDock OS everywhere. Available for all platforms.

Install on Linux Install on macOS Install on Windows Deploy with Docker Compose Deploy on Oracle Cloud

100K+ downloads only on Docker Hub. Thank you!

Website Documentation Changelog GitHub Discord


HomeDock OS in action: searching the Start menu, Jellyfin as an OnScreen App, Sheets, the PDF Editor and Writer, photos with the Image Viewer, video and music with a live spectrum, Quick View, the App Store and Packet Snake


HomeDock OS in Numbers

800+ self-hosted apps, 80+ file types in the browser, 0 plugins to install, 3 operating systems, free forever

  • 800+ apps — 180+ curated in the official App Store, plus community stores one click away.
  • 80+ file types — Photos, camera RAWs, PSDs, spreadsheets, CSVs, Word documents, PowerPoint presentations, PDFs, code, music and video, right in the browser.
  • Zero plugins — No office suite, no codecs, no image editor to install. It all ships inside HomeDock OS.
  • 3 OSes, 4 architectures — Linux, macOS and Windows, on x86, x86_64, ARM and ARM64. Yes, even a Raspberry Pi Zero.
  • 1 certificate — A single automatic Let's Encrypt wildcard covers every app you install, without opening a port for it.
  • €0, forever — The full desktop, free. No trial, no account, no strings attached.

Why HomeDock OS?

Make your apps follow your path, not your steps. Transform the way you manage your apps and data, prioritizing privacy and control in a world where everything is tracked.

Universal Compatibility
Any device is your new device. HomeDock OS runs on Linux, Windows, macOS and Raspberry Pi, on legacy and modern hardware alike.
Privacy by Design
Your data, your rules. Your files stay on your machine, encrypted where it matters, both on-premise and in the cloud.
Reachable From Anywhere
Any device with a browser is a way in, with HTTPS certificates HomeDock OS obtains and renews for you.
A Desktop, Not a Dashboard
Powered by our Prism Window Manager, HomeDock OS feels like the operating system on your laptop, not a grid of links.

800+ Apps, One Click Away

800+ apps, one click away: 180+ curated in the official App Store, plus seven community stores (Casa App Store, BigBearTechWorld, ReCasa App Store, TMC Store, Zima App Store, Coolstore and Casa LinuxServer) converted to HomeDock OS packages automatically. Browse the catalogue.

Jellyfin, Immich, Nextcloud, Home Assistant, Plex, Vaultwarden, Pi-hole and dozens more self-hosted apps
Jellyfin, Immich, Nextcloud, Home Assistant, Plex, Vaultwarden, Pi-hole… and hundreds more.

The HomeDock OS App Store: categories, featured apps like WordPress and WPS Office, and apps such as Immich, Nextcloud, Vaultwarden and Jellyfin

Official App Store
180+ curated applications, from Nextcloud to Jellyfin, Immich to Home Assistant, in an App Store you already know how to use: Discover, categories, a Library with what you installed, and an Updates tab. Install anything in seconds.
Seven Community Stores*
Casa App Store, BigBearTechWorld, ReCasa App Store, TMC Store, Zima App Store, Coolstore and Casa LinuxServer, one click each from Packager. Their apps are converted to HomeDock OS packages automatically, icons, volumes, networks and ports included, taking your catalogue past 800 applications.
Know Before You Download
Every app page shows how much it will download on your server, dependencies included, and warns you when an app wasn't built for your processor before you install it.
Advanced Install Config
Ports, volumes, environment variables, network mode, capabilities and privileged mode, or the raw compose file if you prefer. Port conflicts tell you exactly which app is in the way, and default credentials come with copy-to-clipboard.
Packager
Build your own .hds packages from any Docker Compose file with a live preview of how they'll look in the App Store, bundle dozens of them into a .hdstore file, and migrate CasaOS compose files in one drop. Open formats: every package is a signed ZIP you can always unzip.
Automatic Updates
Apps on :latest are checked in the background, with a badge in the taskbar and an Update All button when there's more than one.

* Community stores are run by their own maintainers and subject to availability. If one goes offline, it temporarily disappears from Packager until it's back.


Opens Your Files, No Plugins Required

Double-click a file in the File Explorer and it opens right there, in your browser, with nothing extra to install. Photos show real thumbnails, and you can drop files from your computer straight onto any viewer.

File icons for JPG, PNG, PSD, DNG, XLSX, CSV, DOCX, PPTX, PDF, MD, PY, TS, ZIP, MP4, WEBM, MP3 and FLAC

Formats

Images
JPG PNG GIF WebP BMP ICO TIFF PSD AVIF TGA DDS ICNS JPEG 2000 QOI

Camera RAW
DNG Canon CR2 Nikon NEF NRW Sony ARW SRF SR2 Panasonic RW2 Pentax PEF Samsung SRW Fujifilm RAF

Spreadsheets
XLSX opened and edited in Sheets, with formulas and formatting kept intact · CSV TSV edited as a sheet and saved back with their own separator

Documents
DOCX opened and edited in Writer · PDF in the PDF Editor: search, fill in forms, annotate, sign and reorder pages · TXT Markdown with live preview in Notepad

Presentations
PPTX opened in Slides, with slide thumbnails and a full-screen presenter mode

Code
Python JavaScript TypeScript Go Rust Java C / C++ C# PHP Ruby Swift Kotlin Shell SQL HTML CSS JSON YAML TOML Dockerfile and more, 45 extensions with syntax highlighting

Archives
ZIP TAR TAR.GZ TGZ browsed, previewed and extracted in Zipfile, password-protected ZIPs included · compress anything to ZIP, with or without a password

Video
MP4 M4V WebM OGV

Audio
MP3 WAV AAC OGG FLAC with cover art and a 3D/2D live spectrum analyzer

Every file is checked against its magic bytes before it opens, so a renamed executable never gets treated as a picture.


A Real Desktop in Your Browser

OnScreen Apps: Nextcloud, Jellyfin and Firefox open as real windows on the HomeDock OS desktop, with the taskbar below

Prism Window Manager
Resizable, draggable, snappable windows with real multitasking: watch logs while an app installs and files upload. Quick View (F3) spreads every open window out at once.
OnScreen Apps
Your self-hosted apps open inside HomeDock OS as real windows, not as a pile of browser tabs. Put Jellyfin next to Immich next to a terminal and use them all at once.
Start Menu & Finder
Start typing and your apps and files show up. Pin what you use, find what you opened last, and search everything Spotlight-style.
Widgets
Clock, System, Storage, Notes, Network, Calendar, Media and Shortcut, right on the desktop.
Your Desktop Follows You
Folders, icons, widgets and pins are stored on the server, so every device sees the same desktop, rearranged to fit its screen.
Built for Phones Too
Swipeable home screen pages, full-screen windows, long-press menus and an App Store with a tab bar, like the phone in your pocket.
Three Themes
Default (light), Noir (dark) and Aero+ (glass), themed down to the last context menu. Bring your own wallpaper.

Your Apps, Under Control

Control Hub: live CPU, memory, disk, network and load graphs in the Performance tab, with processes, app history, dependencies and details

A Terminal for Every App
Right-click any app and get a real shell inside its container, with the right shell picked for you, colors, and extra keys on phones. Closing the window actually ends the session.
Control Hub
A Task Manager for your server: live CPU, memory, disk, network and temperature graphs, per-app processes, history, dependencies and details.
Live Logs
Always live, in color, searchable, and downloadable by time range.
Dependencies You Can See
When an app's database is down, the app's icon tells you instead of letting you guess.

File Management

File Explorer in grid view on the Photos folder with real thumbnails, next to the Image Viewer showing the selected photo

Unified File Explorer
Four places in one window: Storage (your files), Drop Zone (AES-256-GCM encrypted), App Drive (your apps' own volumes) and Disks+ (every physical disk). Favorites, recents, grid and list views, multi-selection and thumbnails.
Disks+
Internal SSDs, USB drives and optical drives, behind your password, with protected zones for system paths and hot-plug detection.
Drop Zone Encryption
AES-256-GCM with HKDF-derived per-user keys and atomic writes.
App Drive
Browse, upload and edit files inside your containers' volumes, including folders outside HomeDock OS once you confirm it's you. Works on Windows too.
Uploads That Don't Get Lost
Progress for every location in the taskbar, with queues and full folder drops.

Built-in Apps

Writer editing a Word document, Sheets with an Excel spreadsheet and the PDF Editor, opened from the File Explorer's Documents folder

Sheets
Open, edit and save Excel spreadsheets, CSV and TSV files.
Writer
Open, edit and save Word documents.
Slides
View PowerPoint presentations with slide thumbnails, and present them full screen.
Notepad
Text and Markdown with live side-by-side preview.
Code
A tabbed code editor with syntax highlighting for 45 file types.

Image Viewer & Brusher
View everything from PNGs to camera RAWs with zoom and pan, and sketch or annotate in Brusher.
Media Player
Video and audio with a live spectrum analyzer and taskbar controls.
PDF Editor
Search the text, fill in forms, highlight, write, draw, add images and sign, then save back to the same file. Reorder, delete or extract pages from the sidebar. Powered by PDF.js.
Zipfile
Browse ZIP and TAR archives, open any file inside without extracting, and extract or compress with an optional password.
Calendar & World Clock
Color-coded calendars, ICS import and export, and up to 12 time zones.
Calculator
With full keyboard support.

Games
Neon Rush, an endless neon arcade racer, and Packet Snake, the classic snake eating packets with your apps' icons. Gamepad and touch included. Built entirely with Three.js and zero assets: every model is procedural and every song and sound effect is synthesized live. Because almost every OS ships with a game or two, so why shouldn't we?

Security & Encryption

Two-Factor Authentication (2FA)
TOTP-compatible with Google Authenticator, Authy, Microsoft Authenticator and more. QR setup, 10 backup codes and "Trust this device" for 30 days.
Single Sign-On for Every App
Apps without a login of their own inherit yours: requests without a HomeDock OS session never reach them. A per-app Exposure switch covers companion apps that can't sign in.
Hybrid RSA + AES-GCM Encryption
4096-bit RSA-OAEP for key exchange and AES-256-GCM for data. Passwords, settings and Disks+ unlocks are encrypted end-to-end even without HTTPS.
Hardened by Default
Path traversal protection, symlink validation, null byte injection prevention, CSRF validation on every endpoint, rate limiting, DoS limits and input sanitization throughout.
Proactive CVE Patching
We patch vulnerabilities within hours of disclosure, often before they're even a day old. The changelog speaks for itself.

Networking & Deployment

Built-In Reverse Proxy
Every app gets its own address (jellyfin.yourdomain.com) instead of a fragile subfolder. Installing an app is the whole setup: no proxy entries, no virtual hosts, no DNS records.
Automatic HTTPS
Pick your DNS provider, paste a token, and HomeDock OS obtains a Let's Encrypt wildcard certificate over DNS, without opening a single port for it. Apps that only speak HTTP are served over HTTPS anyway.
Automatic IP Updates
Your domain keeps pointing home when your ISP changes your IP.
Docker-in-Docker
Run HomeDock OS itself in a container, with automatic host detection and path translation.
Server-Sent Events
One real-time stream instead of a dozen polling endpoints, with delta-only updates and automatic reconnection.
Local DNS (mDNS)
Reach your instance at homedock.local on day one.

Performance & Polish

Window Memory: minimized windows are kept, trimmed or recycled based on your device's memory. Virtualized Lists: the App Store and Logs draw only what's on screen. Lazy Loading: every app, editor and game downloads the first time you open it. Smart Notifications: dismissed once and gone for good.


System Compatibility

HomeDock OS is designed to be universally compatible across platforms and architectures:

Runs on Linux, macOS and Windows; Intel, AMD and Arm; Raspberry Pi, Mini-PCs, ZimaBoard, Umbrel and old laptops; bare metal, Docker Compose, Docker-in-Docker and Oracle Cloud Free Tier

Whether you're using a Raspberry Pi, an old laptop or the latest workstation, HomeDock OS adapts to your setup. It detects applications installed by similar systems, and imports their stores and compose files, so moving over takes minutes.


Why HomeDock OS Exists

Built here first. Someone has to come up with the next idea. Just kidding: the whole self-hosting scene gets better when ideas travel, and we're far from running out of ours. Hardware-first: built around the box, cloud OSes that grew up around the hardware they shipped on. Software-first: built for the software, HomeDock OS runs on whatever machine you already own, with hardware optional.

Several ideas that first shipped here now show up all over the self-hosting OS playground, often months later and in much bigger projects. Each date links to the commit that shipped it:

A Real Window Manager in the Browser
Real windows instead of a dashboard of links, open source today as Prism Window Manager under the AGPL-3.0.
First shipped in 2.0.1.82 on October 15, 2025 Open-sourced in 2.6.2.86 on October 2, 2026
Your Apps' Files, One Click Away
App Drive opens every container volume in a regular file explorer, no terminal needed.
First shipped in 2.0.4.212 on December 21, 2025

A Notepad and a Code Editor, Built In
Text, Markdown and code, edited right in the browser.
Notepad first shipped in 2.1.0.232 on January 16, 2026 Code and the Markdown preview first shipped in 2.1.4.682 on April 26, 2026

An Office Suite Nobody Had to Install
Sheets and Writer edit spreadsheets and Word documents right in the browser.
First shipped in 2.6.2.86 on October 2, 2026

After all, ideas only travel this far when they work.


Built in the Open

The pieces HomeDock OS is made of are becoming standalone open-source projects, one by one, under real OSI-approved licenses (open source, totally true this time). HomeDock OS itself stays source-visible for now, and our CONTRIBUTING explains why and when that changes. The same code that runs your desktop, published so anyone can use it, audit it and build on it:

Prism Window Manager (@prism-wm, AGPL-3.0), the windowing system for Vue 3, React and Svelte; and vite-fusion (MIT), the bridge between Flask and Vite with HMR, CSP nonces and React Fast Refresh

  • Prism Window Manager (@prism-wm, AGPL-3.0): the window manager behind every HomeDock OS window. A framework-agnostic core with bindings for Vue 3, React and Svelte: dragging, resizing, snapping, dialogs, and memory management for minimized windows.
  • vite-fusion (pip install vite-fusion, MIT): serves a Vite frontend from Flask, with the dev server and hot reload while you work, the production manifest when you ship, CSP nonces on every tag and React Fast Refresh.

Speaks Your Language

HomeDock OS speaks your language: English, Español, Deutsch, Français, Italiano, Português, 中文, Русский, Українська, 日本語 and 한국어. 19,000+ translated strings, 1,988 per language. Yours next? Tell us on Discord.

Every window, menu, dialog and date is translated into 11 languages, and only the one you use is downloaded. Choose it during setup or anytime from Settings → Interface Language. Missing yours? Tell us on Discord.


Pricing Plans

Running HomeDock OS at home is free. Always. Free: €0 forever, for personal use, the full desktop and every feature, runs on your own computer, no trial, no account, no strings, on Windows, macOS and Linux. Enterprise: custom pricing, on-premise, with office, prospecting and AI modules, tailored to your business, priority support and SLAs, and custom integrations.

You never need to pay to self-host HomeDock OS. Every feature ships in the free version. Enterprise adds separate modules, support and integrations for businesses running it on their own servers, and it is what keeps HomeDock OS free for everyone else. If it makes your day-to-day a little easier, a star on GitHub or a recommendation to a business that could use it goes a long way.


Getting Started with HomeDock OS

Free Download: install HomeDock OS on your devices and turn them into your personal cloud. get.homedock.cloud HomeDock OS Enterprise: tailored on-premise solutions for your business, with Enterprise modules and premium support. Contact Sales


Documentation and Support

All the guidance you need to unlock the potential of HomeDock OS is available in our documentation.

Documentation: guides for installing, configuring and getting the most out of HomeDock OS. docs.homedock.cloud Discord Support: open a ticket on our official Discord server Email us: support@homedock.cloud


Community

Stay Ahead with HomeDock OS Updates. Join our vibrant community and keep up with the latest updates, features, and tips.

Star HomeDock OS on GitHub Join the community on Discord


Credits

A huge thanks to all contributors, partners, and users who make HomeDock OS a reality. Together, we're redefining how the world experiences the cloud.

Special thanks to the contributors, partners and users who make HomeDock OS a reality homedock-oci-free by Adrián Barrio: HomeDock OS on Oracle Free Tier with Terraform


The OS, in Numbers

HomeDock OS is written line by line by a small, self-funded team in Spain. Its Vue and TypeScript desktop and the Python backend that drives Docker are glued together by vite-fusion, and every window you drag, snap or minimize is managed by Prism Window Manager. We needed both to build HomeDock OS, so we built them as standalone packages and gave them back to the community: free, open source and published on PyPI and npm. If they help you build your own thing, they're yours too.

Below, the numbers behind HomeDock OS itself, counted straight from its own source, comments included. Those two packages live in their own repositories and aren't part of the count.

The code in numbers: 132,161 lines across 425 source files in Vue, TypeScript, Python and translations for 10 languages, written in-house


Our mission: work from HomeDock OS, not just on it. The moment you open HomeDock OS, you shouldn't need anything else, so we built the whole desktop: our own window manager, an office suite, a file system that opens 80+ formats and a terminal for every app, all in a single browser tab. 2 open source packages born from our core, 20+ built-in apps, 80+ file formats with zero plugins, 800+ self-hosted apps. Start for free.


Website Documentation GitHub Discord Company


Banshee


thank-you.txt open in Notepad: Thank you for reading this far! (: Not many people scroll all the way down here. You're one of the curious ones, and HomeDock OS was built for exactly that kind of person. Made in Spain.

About

An intuitive, versatile, and powerful home server operating system for self-hosting. Featuring a curated app store and seamless multi-platform support, it’s designed to empower your personal cloud on Raspberry Pi, x86 systems, or your preferred setup.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

931 stars

Watchers

12 watching

Forks

Releases

Packages

Used by

Contributors

Languages