CasaOS/README.md

80 lines
3.4 KiB
Markdown
Raw Normal View History

2021-09-27 10:41:15 +00:00
# CasaOS - A simple, easy-to-use, elegant open-source home server system.
2021-09-26 02:35:02 +00:00
2021-09-27 08:19:45 +00:00
![CasaOS](https://raw.githubusercontent.com/IceWhaleTech/logo/main/casaos/casaos_banner_aldeyjarfoss.png)
2021-09-27 07:27:05 +00:00
2021-09-27 11:27:16 +00:00
[![Version](https://img.shields.io/github/v/release/IceWhaleTech/CasaOS?color=162453&label=CasaOS&style=flat-square)](https://github.com/IceWhaleTech/CasaOS)
2021-09-27 07:27:05 +00:00
[![Pull Requests](https://img.shields.io/github/issues-pr/IceWhaleTech/CasaOS?color=162453&style=flat-square)](https://github.com/IceWhaleTech/CasaOS/pulls)
[![Issues](https://img.shields.io/github/issues/IceWhaleTech/CasaOS?color=162453&style=flat-square)](https://github.com/IceWhaleTech/CasaOS/issues)
2021-09-27 09:31:30 +00:00
[![GitHub Stars](https://img.shields.io/github/stars/IceWhaleTech/CasaOS?color=162453&logo=github&style=flat-square)](https://github.com/IceWhaleTech/CasaOS/stargazers)
2021-09-27 07:27:05 +00:00
[![Discord](https://img.shields.io/discord/884667213326463016?color=162453&label=Chat&logo=discord&logoColor=fff&style=flat-square)](https://discord.gg/Gx4BCEtHjx)
2021-09-27 10:42:37 +00:00
CasaOS is an open-source home server system based on the Docker ecosystem and designed for home scenarios. It is committed to building the world's most simple, easy-to-use, and elegant home server system.
2021-09-27 07:27:05 +00:00
2021-09-27 10:41:15 +00:00
IceWhale team believes that through community-driven collaborative innovation and open communication with global developers, we can reshape the digital home experience like never before.
2021-09-27 07:27:05 +00:00
2021-10-20 03:23:25 +00:00
![CasaOS Snapshot](snapshot.png)
2021-11-12 09:52:16 +00:00
![CasaOS Snapshot Mobile](snapshot-mobile.png)
2021-09-27 07:27:05 +00:00
2021-10-20 03:10:51 +00:00
## Getting Started
> ⚠️ Note:
>
> CasaOS is still in the early development stage and may vary significantly with the final release. Feel free to test run and share your feedback in the [Discord server](https://discord.gg/Gx4BCEtHjx)!
### Quick Setup CasaOS
2021-10-20 03:23:25 +00:00
Fresh install a system from the list below and run the this command:
2021-10-20 03:10:51 +00:00
2021-11-03 02:51:32 +00:00
```sh
wget -qO- https://get.icewhale.io/casaos.sh | bash
```
or
2021-10-20 03:10:51 +00:00
```sh
curl -fsSL https://get.icewhale.io/casaos.sh | bash
```
### System Compatibility
- Ubuntu Server 20.04 amd64 (✅ Recommend, Tested)
- Raspberry Pi Lite OS aarch64/arm64 (⚠️ Not Fully Tested Yet)
- Debian 11 amd64 (⚠️ Not Fully Tested Yet)
- OpenWrt 21.02 amd64 (⚠️ Not Fully Tested Yet)
2021-11-12 09:52:16 +00:00
- OpenWrt 21.02 aarch64/arm64 (⚠️ Not Fully Tested Yet)
2021-10-20 03:10:51 +00:00
2021-09-28 14:48:40 +00:00
## Key Features
2021-09-27 07:27:05 +00:00
2021-09-27 10:41:15 +00:00
- UI designed for home scenarios - simple, elegant, and easy-to-use
2021-09-28 14:48:40 +00:00
- Quick Docker app installation with only three steps, plus automatic management
2021-11-12 09:52:16 +00:00
- App Store for Home Cloud 🚧
2021-09-27 10:41:15 +00:00
- Home data/digital asset management 🚧
- Smart home manager 🚧
2021-09-27 07:27:05 +00:00
2021-09-27 10:41:15 +00:00
🚧 is under development.
2021-09-27 07:27:05 +00:00
2021-09-28 14:48:40 +00:00
We are actively moving forward with development, and you are more than welcome to share any idea with us!
2021-09-27 07:27:05 +00:00
2021-09-27 08:10:41 +00:00
## Community
2021-09-27 07:27:05 +00:00
2021-09-27 10:41:15 +00:00
The word Casa comes from the Spanish word for "home". Project CasaOS originated as a pre-installed system for crowdfunded product [ZimaBoard](https://www.zimaboard.com) on Kickstarter.
2021-09-27 07:27:05 +00:00
2021-09-27 10:41:15 +00:00
After looking at many systems and software on the market, the team found no server system designed for home scenarios, sadly true.
2021-09-27 07:27:05 +00:00
2021-09-27 10:41:15 +00:00
So, we set out to build this open source project to develop CasaOS with our own hands, everyone in the community, and you.
2021-09-27 07:27:05 +00:00
2021-09-27 10:41:15 +00:00
> A warm welcome for you to share and discuss your great ideas in the [Discord server](https://discord.gg/Gx4BCEtHjx)!
2021-09-27 07:27:05 +00:00
[![Discord Card](https://discordapp.com/api/guilds/884667213326463016/widget.png?style=banner2)](https://discord.gg/Gx4BCEtHjx)
2021-09-27 11:29:56 +00:00
2021-09-27 11:08:39 +00:00
## Maintainers
- Jerry Liu
- Link Liang
- Ober Zhang
- Zyaire Ann
- John Guan
2021-09-28 14:48:40 +00:00
- Right here, waiting for YOU!