Skip to content
alvins82
CasaOS
Public

About

CasaOS - A simple, easy-to-use, elegant open-source Personal Cloud system.

casaos.zimaspace.com

Resources

Readme
License

Code of conduct

Code of conduct

Security policy

Security policy
Activity

Stars

10 stars

Watchers

0 watching

Forks

0 forks
Report repository
BranchesTags
 
 

Latest commit

 

History

742 Commits

Folders and files

NameName
Last commit message
Last commit date
.github
.github
 
 
UI @ 540c8bf
UI @ 540c8bf
 
 
api
api
 
 
build
build
 
 
cmd
cmd
 
 
common
common
 
 
conf
conf
 
 
drivers
drivers
 
 
interfaces
interfaces
 
 
internal
internal
 
 
model
model
 
 
pkg
pkg
 
 
route
route
 
 
service
service
 
 
types
types
 
 
.all-contributorsrc
.all-contributorsrc
 
 
.gitignore
.gitignore
 
 
.gitmodules
.gitmodules
 
 
.goreleaser.debug.yaml
.goreleaser.debug.yaml
 
 
.goreleaser.yaml
.goreleaser.yaml
 
 
CHANGELOG.md
CHANGELOG.md
 
 
CODE_OF_CONDUCT.md
CODE_OF_CONDUCT.md
 
 
DEVELOPING.md
DEVELOPING.md
 
 
LICENSE
LICENSE
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 
SECURITY.md
SECURITY.md
 
 
go.mod
go.mod
 
 
go.sum
go.sum
 
 
main.go
main.go
 
 
openapitools.json
openapitools.json
 
 
package.json
package.json
 
 
snapshot-dark.jpg
snapshot-dark.jpg
 
 
snapshot-light.jpg
snapshot-light.jpg
 
 
snapshot-mobile.png
snapshot-mobile.png
 
 
snapshot.png
snapshot.png
 
 
tsconfig.json
tsconfig.json
 
 

Repository files navigation

CasaOS - Your Personal Cloud

CasaOS
Connect with the community, establish autonomy, reduce the cost of SaaS, and MAXIMIZE the potential for a personalized copilot.

CasaOS Version CasaOS License CasaOS Pull Requests CasaOS Issues CasaOS Stargazers
IceWhale Discord CasaOS GitHub Discussions All Contributors YouTube Tutorial Views
twitter ZimaSpace facebook ZimaSpace
Website | Demo | GitHub

CasaOS Snapshot

Migrate from official CasaOS

If CasaOS was installed from IceWhale's official installer, you can migrate to the latest release of this fork in place. Run the command from an SSH session or a directly attached terminal; do not uninstall CasaOS first.

curl -fsSL https://github.com/alvins82/CasaOS-Install/releases/latest/download/install.sh | sudo bash

The installer stops and restarts CasaOS services while upgrading, so back up important data first. After it finishes, verify the installed fork release with:

cat /var/lib/casaos/fork-release

The command should print the fork release tag installed on the system, such as v0.4.35 for the current release.

Future updates can be installed from the CasaOS dashboard or by running the same command again. Do not use get.casaos.io/update after migrating, because it installs IceWhale's upstream component bundle.

Fork Changelog

Why do you need Personal Cloud?

In 2020, the team noticed three important trends:

  • The cost of computing power and storage was decreasing fast.
  • A part of cloud computing was moving towards edge computing.
  • The issue of consumer data asset ownership and attribution had been ignored.

Based on these trends, the team proposed a thought experiment internally: what if personal clouds were available under $100 in next five years? This personal cloud would provide a low-cost data collaboration solution as a personal data center, storing and managing data for creators and small organizations. A distributed collaborative computing network can be formed by personal servers located around the world. It could also control and connect all smart devices, providing cross-ecosystem local intelligent services.

Furthermore, the personal cloud could combine personal data to train personalized AI assistants. The idea is that this technology would be an effective way to solve the issue of consumer data asset ownership and , as well as provide a more affordable and efficient computing solution for individuals and small organizations.

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

Features

  • 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, HomeAssistant, 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 12 (✅ Tested, Recommended)
  • Ubuntu Server 26.04 (✅ Tested by this fork)
  • 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

Install this fork with the maintained CasaOS-Install release so that all component compatibility fixes are included.

Install the latest stable release with one command:

curl -fsSL https://github.com/alvins82/CasaOS-Install/releases/latest/download/install.sh | sudo bash

This runs the same released install.sh on every supported operating system and architecture.

Do not use get.casaos.io to install this fork; that endpoint installs IceWhaleTech's upstream component bundle.

Update CasaOS

The CasaOS dashboard checks CasaOS-Install releases and installs updates from this fork, so upstream updates cannot replace the patched components. Release tags are platform-neutral starting with v0.4.18; the installer detects the operating system and architecture at runtime. You can also repeat the installation command above at any time.

Existing v0.4.17-ubuntu26.2 installations must run the installation command above once to enable the fork-aware updater; future releases can then be applied from the dashboard.

To check the installed fork release from a terminal, run:

cat /var/lib/casaos/fork-release

Uninstall CasaOS

v0.3.3 or newer

casaos-uninstall

Before v0.3.3

curl -fsSL https://get.icewhale.io/casaos-uninstall.sh | sudo bash

Community

The word Casa comes from the Spanish word for "home". Project CasaOS originated as a pre-installed system for the 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 believe 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

Contributing

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!

Credits

Many thanks to everyone who has helped CasaOS so far!

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


老竭力
💻 📖 🤔 🚇 🚧 📦 💬 👀
link
💻 📖 🤔 🚇 🚧 💬 👀
太戈
💻 📖 🤔 🚇 🚧 🧑‍🏫 🛡️ 💬 👀
Lauren
🤔 🔍 📆 💬 ⚠️
John Guan
📝 🖋 📖 🤔 📋 🧑‍🏫 💬 👀
David Tippett
📖 🤔 💬
Skaya
🧑‍🏫 💬 ✅ 🌍

AuthorShin
⚠️ 🐛 💬 🤔
baptiste313
🌍
DrMxrcy
⚠️ 🤔 💬
Joooost
🤔
Vitaly Potyarkin
🤔
Bjørn Friese
🤔
Protektor
🐛 🤔 💬

llwaini
📆 ⚠️ ✅
CorrectRoadH
💻 📖
zhanghengxin
💻 📖

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

Changelog

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

trackgit-views

About

CasaOS - A simple, easy-to-use, elegant open-source Personal Cloud system.

casaos.zimaspace.com

Resources

Readme
License

Code of conduct

Code of conduct

Security policy

Security policy
Activity

Stars

10 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages