CasaOS,一个简洁易用、开源的家庭云系统,支持一键安装各类 NAS / 家庭智能应用,可快速在本地搭建与托管电影、音乐、游戏等家庭娱乐服务。

link e8db1767e5 Update 1 week ago
.github fcfb48d88e enable code coverage (#825) 1 week ago
build 9eb650b444 Add download triage for download migration-tool (#793) 3 weeks ago
cmd 84f17b4c4b add `upx` as part of building step to shrink the size of binary files (#797) 4 weeks ago
conf 381fb85b1d v0.3.7 (#600) 3 months ago
interfaces 70ba4d5e3d 0.3.6 (#519) 4 months ago
model ea166f890b remove deps under GPL and add license check to workflow 1 month ago
pkg 8cff99f726 enable unit tests as part of release process (with 3 always failing tests skipped) 1 month ago
route 86380d912d Allow specific special characters (#823) 1 week ago
service be50579544 add update type (#812) 2 weeks ago
types 0155dc1877 bump version from 0.4.0 to 0.4.1 1 month ago
.all-contributorsrc c23bd3f3a3 docs: add llwaini as a contributor for projectManagement, test, tutorial (#379) 6 months ago
.gitignore 8a37f9c879 Merge branch 'heads/v0.3.7' 2 months ago
.gitmodules f0f0eb2ef0 🦄 refactor: 1 year ago
.goreleaser.debug.yaml b2a4fafdb4 add race detection for tests 1 week ago
.goreleaser.yaml b2a4fafdb4 add race detection for tests 1 week ago e8db1767e5 Update 1 week ago b0dc30277b Adding simple Developing file (#311) 7 months ago
LICENSE 403d563869 Create LICENSE 1 year ago
Makefile 2491a03d4b update makefile 1 year ago fcfb48d88e enable code coverage (#825) 1 week ago
go.mod be50579544 add update type (#812) 2 weeks ago
go.sum be50579544 add update type (#812) 2 weeks ago
main.go 84f17b4c4b add `upx` as part of building step to shrink the size of binary files (#797) 4 weeks ago
snapshot-dark.jpg d48e24f652 Create snapshot-dark.jpg 6 months ago
snapshot-light.jpg 3a8cf593d9 Create snapshot-light.jpg 6 months ago
snapshot-mobile.png 88c15104b4 update 1 year ago
snapshot.png 32e00b17b1 update 1 year ago

CasaOS - Your Home Cloud OS

Connect with the community developing HOME CLOUD, creating self-sovereign, and defining the future of the distributed cloud.

CasaOS Version CasaOS License CasaOS Pull Requests CasaOS Issues CasaOS Stargazers
IceWhale Discord CasaOS GitHub Discussions All Contributors
Website | Demo | GitHub

CasaOS Snapshot

Why do we need Home Cloud?

Think about it seriously. Is control of our data, smart devices and digital assets now only in the hands of some big company?

  • Is your photo album saved in their cloud service?
  • Do your thermostats, monitors, lamps need to be used through their cloud services?
  • Do your personal documents, memos, contacts, passwords, etc. reside in their cloud storage services?
  • Are you just going to have to accept their decisions when they decide to change prices, review content or even discontinue services?

It sounds ridiculous, doesn't it? We are losing control of our own data!

Our ideal home cloud is one where you can manage all your data, devices and data assets very easily. In your own home, you have absolute control.

If you think what we are doing is valuable. Please give us a star ⭐ and fork it 🤞!


  • Friendly UI designed for home scenarios
    • No code, no forms, intuitive, design for humanity
  • Multiple hardware and base system support
    • ZimaBoard, NUC, RPi, old computers, whatever is available.
  • Selected apps in the app store, one-click installation
    • Nextcloud, HomeAssiant, AdGuard, Jellyfin, *arr and more!
  • Easily install numerous Docker apps
    • Over 100,000 apps from the Docker ecosystem can be easily installed
  • Elegant drive and file management
    • What you see is what you get. No technical background required.
  • Well-designed system/app widgets
    • What you care about, at a glance. Resource usage, app status, and more!

Getting Started

CasaOS fully supports ZimaBoard, Intel NUC, and Raspberry Pi. Also, more computers and development boards and fully compatible with Ubuntu, Debian, Raspberry Pi OS, and CentOS with one-liner installation.

Hardware Compatibility

  • amd64 / x86-64
  • arm64
  • armv7

System Compatibility

Official Support

  • Debian 11 (✅ Tested, Recommended)
  • Ubuntu Server 20.04 (✅ Tested)
  • Raspberry Pi OS (✅ Tested)

Community Support

  • Elementary 6.1 (✅ Tested)
  • Armbian 22.04 (✅ Tested)
  • Alpine (🚧 Not Fully Tested Yet)
  • OpenWrt (🚧 Not Fully Tested Yet)
  • ArchLinux (🚧 Not Fully Tested Yet)

Quick Setup CasaOS

Freshly install a system from the list above and run this command:

wget -qO- | sudo bash


curl -fsSL | sudo bash

Uninstall CasaOS

v0.3.3 or newer


Before v0.3.3

curl -fsSL | sudo bash


The word Casa comes from the Spanish word for "home". Project CasaOS originated as a pre-installed system for crowdfunded product ZimaBoard on Kickstarter.

After looking at many systems and software on the market, the team found no server system designed for home scenarios, sadly true.

So, we set out to build this open source project to develop CasaOS with our own hands, everyone in the community, and you.

We believes that through community-driven collaborative innovation and open communication with global developers, we can reshape the digital home experience like never before.

A warm welcome for you to get help or share great ideas in the Discord!

Discord Card


CasaOS is a community-driven open source project and the people involved are CasaOS users. That means CasaOS will always need contributions from community members just like you!


Many thanks to everyone who has helped CasaOS so far!

Everyone's contribution is greatly appreciated. (Emoji Key)


💻 📖 🤔 🚇 🚧 📦 💬 👀


💻 📖 🤔 🚇 🚧 💬 👀

Tiger Wang (王豫)

💻 📖 🤔 🚇 🚧 🧑‍🏫 🛡️ 💬 👀


🤔 🔍 📆 💬 ⚠️

John Guan

📝 🖋 📖 🤔 📋 🧑‍🏫 💬 👀

David Tippett

📖 🤔 💬


🧑‍🏫 💬 🌍


⚠️ 🐛 💬 🤔




⚠️ 🤔 💬



Vitaly Potyarkin


Bjørn Friese



🐛 🤔 💬


📆 ⚠️

This project follows the all-contributors specification. Contributions of any kind welcome!


Detailed changes for each release are documented in the release notes.