Adding Apps to the Store

Want to add an app to the Companion App Store? Submit through our web form or open a pull request.

Quick submit

Visit ci.computer/store-submit  — the fastest path to get your app reviewed and listed.

See the full Submitting to the Marketplace guide for requirements, examples, and review process.

Prerequisites

• The app must run as a Docker container
• A public or submit-able Docker image (or build with the Static Container Builder)
• A GitHub account (for PR submissions)

App structure

Each app lives in apps/<slug>/ in the CI-Marketplace  repository. Use Nextcloud  as a reference.

• apps/my-app
  • config.json
  • docker-compose.json
  • README.md
  • metadata
    • description.md
    • logo.png

Required files

config.json

Contains name, description, port, categories, form fields, supported architectures, and optional hub_integration for AI/MCP apps.

docker-compose.json

Dynamic compose schema (version 2) defining images, ports, volumes, health checks, and ${ENV_VAR} references. See Dynamic Compose.

Process

1. Create apps/<slug>/ with the required files
2. Test locally via a custom app store pointing at your fork
3. Submit via store-submit  or open a PR to CI-Marketplace

Guidelines

• Use official Docker images where possible
• Provide sensible defaults; use random fields for secrets
• Set supported_architectures accurately
• Add hub_integration.inference if your app uses Hub AI variables
• Test a clean install on a fresh Hub instance