CasaOS
CasaOS - A simple, easy-to-use, elegant open-source Personal Cloud system.
Top Related Projects
Documentation and Examples of base container modifications
A list of Free Software network services and web applications which can be hosted on your own servers
YunoHost is an operating system aiming to simplify as much as possible the administration of a server. This repository corresponds to the core code, written mostly in Python and Bash.
Quick Overview
CasaOS is an open-source home cloud system designed to simplify the process of setting up and managing a personal server. It provides a user-friendly interface for managing various applications, files, and system resources, making it accessible for both beginners and advanced users.
Pros
- Easy to install and set up, with a simple one-click installation process
- User-friendly web interface for managing applications and system resources
- Supports a wide range of applications through Docker containers
- Active community and regular updates
Cons
- Limited customization options compared to more advanced server management solutions
- May not be suitable for large-scale or enterprise deployments
- Some users report occasional stability issues or bugs
- Documentation could be more comprehensive for advanced users
Getting Started
To get started with CasaOS, follow these steps:
- Ensure you have a compatible system (x86_64 or ARM64 architecture) running a supported Linux distribution.
- Open a terminal and run the following command to install CasaOS:
curl -fsSL https://get.casaos.io | sudo bash
- Once the installation is complete, access the CasaOS web interface by opening a web browser and navigating to
http://your-server-ip:80. - Follow the on-screen instructions to complete the initial setup and start using CasaOS.
For more detailed instructions and troubleshooting, refer to the official documentation at https://github.com/IceWhaleTech/CasaOS/wiki.
Competitor Comparisons
Documentation and Examples of base container modifications
Pros of docker-mods
- Highly modular approach, allowing easy customization of existing Docker images
- Extensive collection of pre-built mods for various applications
- Seamless integration with LinuxServer.io container ecosystem
Cons of docker-mods
- Limited to modifying existing containers, not a full-fledged operating system
- Requires familiarity with Docker and container concepts
- May have compatibility issues with non-LinuxServer.io containers
Code Comparison
CasaOS configuration example:
version: "3"
services:
casaos:
image: icewhaletch/casaos:latest
volumes:
- /etc/casaos:/etc/casaos
docker-mods usage example:
docker run -e DOCKER_MODS=linuxserver/mods:universal-package-install \
linuxserver/baseimage-ubuntu
While CasaOS provides a complete operating system solution for home servers, docker-mods focuses on enhancing existing Docker containers with additional functionality. CasaOS offers a more comprehensive approach to managing a home server environment, while docker-mods provides flexibility in customizing individual containers. The choice between the two depends on the user's specific needs and level of expertise in container management.
A list of Free Software network services and web applications which can be hosted on your own servers
Pros of awesome-selfhosted
- Comprehensive list of self-hosted software options
- Regularly updated with new projects and information
- Categorized for easy navigation and discovery
Cons of awesome-selfhosted
- Requires more technical knowledge to implement individual solutions
- No integrated management interface for multiple services
- May overwhelm users with too many choices
Code comparison
While a direct code comparison isn't relevant due to the nature of these projects, here's a brief example of how they differ:
awesome-selfhosted (README.md):
## Analytics
- [Ackee](https://github.com/electerious/Ackee) - Self-hosted analytics tool for those who care about privacy.
- [Matomo](https://matomo.org/) - Leading open-source analytics platform that gives you more than just powerful analytics.
CasaOS (main.go):
func main() {
route.InitRouter()
common.StartCasaOS()
}
awesome-selfhosted is primarily a curated list in markdown format, while CasaOS is a full software solution with Go code for its core functionality.
YunoHost is an operating system aiming to simplify as much as possible the administration of a server. This repository corresponds to the core code, written mostly in Python and Bash.
Pros of YunoHost
- More mature project with a larger community and longer development history
- Supports a wider range of applications out-of-the-box
- Offers a command-line interface for advanced users and automation
Cons of YunoHost
- Steeper learning curve for beginners
- Less focus on user-friendly GUI compared to CasaOS
- May require more system resources due to its comprehensive feature set
Code Comparison
YunoHost (Python):
def _get_services_status():
services = _get_services()
statuses = {}
for service in services:
statuses[service] = service_status(service)
return statuses
CasaOS (Go):
func (s *ServiceManager) GetServiceStatus(name string) (string, error) {
service, err := s.systemd.GetService(name)
if err != nil {
return "", err
}
return string(service.SubState), nil
}
Both projects aim to simplify self-hosting, but YunoHost offers a more comprehensive solution with a wider range of applications and advanced features. CasaOS focuses on providing a user-friendly experience with a modern interface, making it more accessible for beginners. YunoHost's code example shows a function to get the status of multiple services, while CasaOS's code retrieves the status of a single service using systemd.
Convert 
designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual CopilotREADME
CasaOS - Your Personal Cloud
Connect with the community, establish autonomy, reduce the cost of SaaS, and MAXIMIZE the potential for a personalized copilot.
Website |
Demo |
GitHub
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 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- https://get.casaos.io | sudo bash
or
curl -fsSL https://get.casaos.io | sudo bash
Update CasaOS
CasaOS can be updated from the User Interface (UI), via Settings ... Update.
Alternatively it can be updated from a terminal session. To update from a terminal session, it must be done either from a secure shell (ssh) session to the device or from a directly attached terminal and keyboard to the device running CasaOS, this cannot be done from the terminal via the CasaOS User Interface (UI). To update to the latest release of CasaOS from a terminal session run this command:
wget -qO- https://get.casaos.io/update | sudo bash
or
curl -fsSL https://get.casaos.io/update | sudo bash
To determine version of CasaOS from a terminal session run this command:
casaos -v
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!
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!
- See https://wiki.casaos.io/en/contribute for ways of contributing to CasaOS
- See https://wiki.casaos.io/en/contribute/development if you want to be involved in code contribution specifically
Donate
Credits
Many thanks to everyone who has helped CasaOS so far!
Everyone's contribution is greatly appreciated. (Emoji Key)
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.
Top Related Projects
Documentation and Examples of base container modifications
A list of Free Software network services and web applications which can be hosted on your own servers
YunoHost is an operating system aiming to simplify as much as possible the administration of a server. This repository corresponds to the core code, written mostly in Python and Bash.
Convert designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual Copilot