A 2023 community video demonstrated how to add WisdomSky's LinuxServer AppStore to CasaOS as a third-party source. The store packages LinuxServer.io container images into CasaOS-compatible app definitions so they can be installed from the dashboard.
This is not the built-in IceWhale App Store and it is not an official LinuxServer.io product. The catalog, templates, update timing, and support remain the responsibility of the third-party repository.
Check CasaOS Version and Back Up App Settings
The repository currently states that custom app stores require CasaOS 0.4.4 or later. Before adding any source, update CasaOS through its supported interface, record existing application volume paths and ports, and back up important AppData.
Watch the community video walkthrough. Interface labels may differ on current CasaOS releases.
Add the LinuxServer Catalog
- Open the CasaOS dashboard and enter the App Store.
- Open Add Source. Some interface versions label this area More apps.
- Copy the current catalog URL from the repository's Installation section.
- Paste the URL into CasaOS and select Add.
- Wait for the import to finish, refresh the App Store, and filter for the LinuxServer source.
https://casaos-appstore.paodayag.dev/linuxserver.zipThe URL above is the current value published by the third-party repository at the time of this rewrite. Verify it against WisdomSky/CasaOS-LinuxServer-AppStore before importing it.
Review an App Before One-Click Installation
The video installed code-server as an example and explained that CasaOS downloads the image and starts it through Docker Compose. Before selecting Install, open the template and inspect:
- host and container volume paths;
- published ports and conflicts;
- PUID, PGID, timezone, and other environment values;
- privileged mode, devices, and capabilities;
- image tag and upstream documentation.
A catalog entry can simplify deployment without guaranteeing that its default paths fit your server.
App Updates Come From Several Layers
The repository says it tracks LinuxServer.io releases automatically. Even so, the catalog template, Docker image, and application database can change independently. Read upstream release notes before major upgrades and preserve the application's configuration and data volumes.
Removing a Source Does Not Equal Uninstalling Apps
If you no longer want the catalog, remove only the source entry. Existing containers and AppData may remain. Inspect them separately before deleting anything; never erase the entire AppData directory to remove one catalog.
CasaOS LinuxServer App Store FAQ
Is this an official IceWhale App Store?
No. It is a third-party CasaOS catalog maintained in a separate community repository.
Why does my interface say “More apps” instead of “Add Source”?
The label changed in some CasaOS versions; the repository issue tracker documents this interface difference.
Does one-click install remove the need to check paths?
No. Verify storage, ports, permissions, and image documentation before installation.
