DZAZ • ZimaOS Guide

How to Add Third-Party App Stores to ZimaOS

A quick walkthrough for adding community CasaOS/ZimaOS app repositories to a ZimaBoard, ZimaBlade, or ZimaCube using the built-in command line.

What this guide does

ZimaOS is based around CasaOS-style Docker apps, but the newer ZimaOS interface does not always show an obvious “Add Source” or “Add App Store” button inside the App Store page. The reliable method is to use the built-in casaos-cli command.

Adding these repositories expands the ZimaOS App Store with extra homelab apps, media tools, automation services, dashboards, security tools, and community Docker templates.

Third-party app stores are community-maintained. Some apps may be outdated, duplicated, broken, or require manual configuration. Only install apps from sources you trust.

Step 1: Open the ZimaOS command line

  • Open your ZimaOS dashboard in a browser.
  • Go to Settings.
  • Open Developer Options.
  • Enable the Command Line.
  • Launch the terminal window.

Step 2: Check your current app stores

Before adding anything new, list the app stores already registered on your system.

casaos-cli app-management list app-stores

Step 3: Add third-party app stores

Copy the command under each app store and paste it into the ZimaOS command line.

LinuxServer App Store

Source: https://casaos-appstore.paodayag.dev/linuxserver.zip

Adds a large collection of stable Docker-based homelab apps from the LinuxServer.io ecosystem.

casaos-cli app-management register app-store https://casaos-appstore.paodayag.dev/linuxserver.zip

Cp0204 AppStore Play

Source: https://play.cuse.eu.org/Cp0204-AppStore-Play.zip

Adds a broad community app collection with self-hosted tools, media apps, dashboards, and experimental services.

casaos-cli app-management register app-store https://play.cuse.eu.org/Cp0204-AppStore-Play.zip

Cp0204 AppStore Play ARM

Source: https://play.cuse.eu.org/Cp0204-AppStore-Play-arm.zip

ARM-focused version of the Cp0204 store. Useful for ARM boards, but usually not needed for Intel-based ZimaBoard systems.

casaos-cli app-management register app-store https://play.cuse.eu.org/Cp0204-AppStore-Play-arm.zip

Coolstore

Source: https://casaos-appstore.paodayag.dev/coolstore.zip

Adds extra community and experimental apps. Good for discovery, but expect some templates to need troubleshooting.

casaos-cli app-management register app-store https://casaos-appstore.paodayag.dev/coolstore.zip

CasaOS AppStore Edge

Source: https://paodayag.dev/casaos-appstore-edge.zip

Adds edge/testing app templates. This may include newer versions or less-tested configurations.

casaos-cli app-management register app-store https://paodayag.dev/casaos-appstore-edge.zip

Home Automation App Store

Source: https://github.com/mr-manuel/CasaOS-HomeAutomation-AppStore

Adds smart home and automation-focused apps for Home Assistant, IoT projects, and home lab automation.

casaos-cli app-management register app-store https://github.com/mr-manuel/CasaOS-HomeAutomation-AppStore/archive/refs/tags/latest.zip

BigBear CasaOS App Store

Source: https://github.com/bigbeartechworld/big-bear-casaos

Popular community store with useful homelab, dashboard, development, and server app templates.

casaos-cli app-management register app-store https://github.com/bigbeartechworld/big-bear-casaos/archive/refs/heads/master.zip

TMC Community App Store

Source: https://github.com/mariosemes/CasaOS-TMCstore

Community app store with a mix of utilities, self-hosted services, and extra CasaOS templates.

casaos-cli app-management register app-store https://github.com/mariosemes/CasaOS-TMCstore/archive/refs/heads/main.zip

CasaOS Pentest-Docker AppStore

Source: https://github.com/arch3rPro/Pentest-Docker

Security-focused CasaOS app store with pentest-related Docker apps such as BeEF, Empire, Viper, Webmap, Reverse Shell Generator, Web-Check, NPS, Next-Terminal, and other tools.

casaos-cli app-management register app-store https://github.com/arch3rPro/Pentest-Docker/archive/refs/heads/master.zip

ZimaOS App Store by justserdar

Source: https://github.com/justserdar/ZimaOS-AppStore

ZimaOS-focused third-party app store with extra community templates designed around the Zima ecosystem.

casaos-cli app-management register app-store https://github.com/justserdar/ZimaOS-AppStore/archive/refs/tags/latest-v0.0.8.zip

Quick copy/paste: add all stores

If you want to add every store from this guide, paste this whole block into the ZimaOS command line.

casaos-cli app-management register app-store https://casaos-appstore.paodayag.dev/linuxserver.zip
casaos-cli app-management register app-store https://play.cuse.eu.org/Cp0204-AppStore-Play.zip
casaos-cli app-management register app-store https://play.cuse.eu.org/Cp0204-AppStore-Play-arm.zip
casaos-cli app-management register app-store https://casaos-appstore.paodayag.dev/coolstore.zip
casaos-cli app-management register app-store https://paodayag.dev/casaos-appstore-edge.zip
casaos-cli app-management register app-store https://github.com/mr-manuel/CasaOS-HomeAutomation-AppStore/archive/refs/tags/latest.zip
casaos-cli app-management register app-store https://github.com/bigbeartechworld/big-bear-casaos/archive/refs/heads/master.zip
casaos-cli app-management register app-store https://github.com/mariosemes/CasaOS-TMCstore/archive/refs/heads/main.zip
casaos-cli app-management register app-store https://github.com/arch3rPro/Pentest-Docker/archive/refs/heads/master.zip
casaos-cli app-management register app-store https://github.com/justserdar/ZimaOS-AppStore/archive/refs/tags/latest-v0.0.8.zip
If you are using an Intel-based ZimaBoard or ZimaCube, you may not need the ARM-specific Cp0204 store.

Step 4: Confirm the stores were added

After adding the stores, run:

casaos-cli app-management list app-stores

The newly added app stores should now appear in the list.

Step 5: Refresh the App Store

Refresh your browser and open the ZimaOS App Store. The apps from the new sources are usually merged into the normal App Store view.

If the apps do not appear, restart CasaOS:

sudo systemctl restart casaos

Where do the apps show up?

The apps usually do not show up as separate tabs for each store. They are normally combined into the main App Store list. Use the App Store search bar to find what you want.

  • Search Kasm for browser-based workspaces.
  • Search Home Assistant for smart home apps.
  • Search BeEF, Webmap, or Web-Check for apps from the Pentest-Docker store.
  • Search Uptime Kuma, code-server, or dashboard for general homelab tools.

How to remove an app store

First list the registered app stores:

casaos-cli app-management list app-stores

Find the store ID you want to remove, then run:

casaos-cli app-management unregister app-store <store-id>

Replace <store-id> with the actual number from your list.

Final notes

Duplicate apps are normal because multiple stores may provide the same app with different Docker Compose templates. If one version fails to install, try another version from a different store.

Only use pentesting and security tools on systems, labs, and networks that you own or have explicit permission to test.