Author: casaos Date: 2023-01-19 Tags:


  • [Disk] Added disk merging feature in storage management (beta) that allows for multiple disks to be merged into a single storage space
  • [System] Added option for search engine
  • [APP] Added app cloning feature in the app's context menu.


  • [APP] Improved app installation process, including display of the installation process, checks for successful installation, and prompts
  • [System] Binary sizes are 40%~60% smaller (thanks to upx)
  • [App] Optimization of install and update for certain country.
  • [All] Lots of bug fixes

Learn more:

Author: Tiger Wang Date: 2023-01-04 Tags: guide

Officially CasaOS runs on Linux only, and there is no Windows version (and not likely to have one in near future). This means that to run CasaOS on Windows 10/11 you would need an Linux environment running on top of it. It can be a Linux virtual machine via Hyper-V, or it can be the WSL2 that comes with Windows.

This post is about how to run CasaOS under Windows with help of WSL2.

Install WSL2

If you already have WSL2 running, make sure you have the latest version. You would need to update WSL2 to latest version to have this support by running wsl.exe --update.
  1. Install the Windows Subsystem for Linux (WSL) by following the instructions in the Microsoft documentation:
  2. Install a Linux distribution from the Microsoft Store. There are several options available, such as Ubuntu, Debian, and Kali Linux.

Enable systemd support

You would need to enable systemd support in WSL2, to keep the modularized CasaOS services running in the background. Add these lines to the /etc/wsl.conf of the Linux distribution you are running in WSL2:


Afteward, you run wsl.exe --shutdown and wsl.exe again to restart WSL2.

See for details.

Install Docker under WSL2

If you are already using Docker on Windows, most likely you are using Docker for Desktop which integrates with WSL2. However that means the Docker engine is running aside from WSL2, so you can run docker command under every WSL2 distribution as well as Windows command prompt. We would need to replace it with a locally running Docker engine.

See for the actual steps of installing Docker engine locally, or or if you are running Ubuntu.

Install CasaOS

Once you have completed the prerequisites above, you can install CasaOS by running the following command:

curl -fsSL | sudo bash

If the installation is successful, you should be able to access the CasaOS login prompt by visiting http://localhost (port 80 by default) in your web browser.

Key Takeaways

  • Install the Windows Subsystem for Linux (WSL) and a Linux distribution on your Windows 10 system.
  • Enable systemd support in WSL2.
  • Install Docker on the Linux distribution in WSL2.
  • Install CasaOS by running the curl -fsSL | sudo bash command.


  • Storage management is not possible in WSL2, as it is essentially a light virtual machine.

We hope this guide is helpful for users who are interested in running CasaOS on Windows 10 with WSL2. Let us know at if you have any questions or if you need further assistance.

Author: Tiger Wang Date: 2022-12-31 Tags: dashboard

Happy New Year, CasaOS users!

While everyone is excited to kick off the new year, we want to disclose a hidden beta feature that was shipped in CasaOS since version 0.3.8, for advanced users who love to try new things.

This feature in CasaOS integrates with MergerFS, a union filesystem that allows you to combine multiple storage devices into a single virtual storage device. With this feature, you can easily access and manage the combined storage space of all your underlying devices through the /DATA directory.

Please note that this feature is currently in BETA and may still have some bugs or issues that need to be ironed out. There is also a risk of data loss and running apps resetting when using this feature, so please use caution and consider making a backup of your data before enabling it.

If you are ready to enable the feature, simply run the following commands after backing up your data and apps:

sudo apt-get --no-install-recommends install mergerfs
[ -z /var/lib/casaos/files ] && sudo mv /DATA /var/lib/casaos/files
sudo rm -rvf /DATA && sudo mkdir /DATA
echo "EnableMergerFS=True" | sudo tee -a /etc/casaos/local-storage.conf
sudo systemctl restart casaos-local-storage.service

Once enabled, you can access the feature in the Storage Manager from the CasaOS dashboard.

We would love to get as much feedback as possible from users who are interested in trying out this preview feature, before we officially making it generally available for all users. If you give it a try, please let us know how it goes and share any feedback or suggestions you have at

Thank you for your continued support of CasaOS. We hope you enjoy this new feature and we look forward to hearing your thoughts on it.