Skip to Content

Custom app stores

Companion Hub can hold more than one app store, and Settings → App Stores lists the ones you have. What you can do there is narrower than it looks, so this page starts with the part that decides whether the rest is useful to you.

You cannot add an app store from the dashboard. The Add App Store button opens a dialog whose submit button is disabled, above the text “Feature coming soon — Custom app store setup is under maintenance. Your Hub uses the CI Marketplace automatically; no manual store URL is needed.” The cihub CLI has no app-store command either. This is the current state of the shipped product, not a configuration problem at your end.

What your Hub actually has

Every Hub registers one store for itself: CI Marketplace, slug ci-marketplace. It is not a Git repository — it is an API-backed store (type: ci_cloud_api) pointed at CI Cloud, registered automatically at startup and kept in sync from there. You do not add it and should not try to remove it.

Git-repository stores — a repo with an apps/ directory, one folder per app, cloned into <ROOT_FOLDER_HOST>/repos/ — are still supported by the sync code, which refers to them as legacy git stores. They are how stores worked before CI Marketplace. Nothing in the dashboard creates one.

The two store types the sync code knows about, and how each reaches the App Store view:

What you can still do in Settings → App Stores

ActionWorks todayNotes
See every store and whether it is enabled✓The table is the full list
Refresh✓Re-syncs enabled stores and invalidates the catalog cache
Edit a store — rename, enable/disable✓The name is capped at 16 characters
Delete a storeConditionallyRefused while the store has installed apps, or when it is the last store
Add a storeNoDialog disabled — see the callout above
Everything the Settings → App Stores page offers, and whether it does anything.

Deleting is refused more often than you would expect

Two rules are enforced by the server, and both return an error rather than doing anything partial:

  • “There are installed apps that belong to this appstore. Please uninstall them first” — a store with any installed app cannot be deleted. Uninstall its apps first.
  • “You cannot delete the last appstore” — your Hub must always have at least one.

Disabling a store is the lighter option: its apps drop out of the App Store view without touching anything you have already installed.

Both rules the server enforces before a store is removed, and the lighter alternative:

The API still exists

Why not call the API directly? The Hub backend does still serve an app-store creation endpoint (POST /api/marketplace/create), so the capability was not deleted from the server. It is not a supported path — nothing in the UI manages a store created that way, and the request shape is not guaranteed — so it is not documented as a workaround here.

Whether the dialog returns is genuinely unsettled: the dialog text says “coming soon”, while the comment in the source that disabled it describes manual store URLs as a removed pre-Companion-Hub feature. The supported path remains unsettled.

Furthermore, manual Git stores only clone static files from Git repositories — they cannot store or stream container layers on Cloudflare R2, lack device-authenticated registry tokens, and cannot provide hardware-enforced runtime DRM or Confidential Containers (CoCo) TEE isolation. The supported, secure architecture for distributing and testing private container apps is pushing containers to the Portal R2 registry with "available": false.

Apps from any store run on your machine with the same access as any other app. A docker-compose.json can mount host paths and read your data — which is why the Settings page carries its own “Make sure you trust the appstores you add!” warning.

If you were trying to test an app before submitting it

That is the usual reason people come looking for this page, and the custom-store route is not available for it. Publish your first app covers what to do instead.

Ready to publish to the community store? Submit at ci.computer/store-submit  — see Submitting an app to the Store for the required files and review process.

Last updated on