Market — BW-Tech / owncloud.online fork #

Marketplace / AppStore integration for ownCloud, modernised for PHP 8.4 and shipped with a fully self-contained local app catalog (no external marketplace required) plus a refreshed UI with dark-mode support and a live search.

This is a community fork maintained by BW-Tech GmbH for owncloud.online. Original code by ownCloud GmbH (AGPL-3.0).

Features #

• Local-first catalog — apps live in marketplace/apps.json inside the plugin directory; no remote backend needed. Add an entry, point download to a GitHub release URL, you're done.
• Drop-in remote mode — set appstoreurl in config.php to use the classic ownCloud marketplace API or your own HTTPS catalog instead.
• PHP 8.4 — constructor property promotion, readonly, #[\Override], typed properties, match, native first-class function syntax.
• Modern UI — refreshed tile cards, custom CSS variables, automatic dark mode via prefers-color-scheme, smoother animations.
• Live search — type to filter the visible app list across name, summary, description and category.
• OCC commands — install, uninstall, list and upgrade apps from the command line.
• Background updates — daily check for available updates, with per-group notifications.

Requirements #

• ownCloud Server 10.x (10.11+ recommended)
• PHP 8.4 or newer
• Composer 2.x (only for development / building the dist artifact)
• Node.js 20 (only for building the JS bundle)

Installation #

cd /var/www/owncloud/apps
git clone https://github.com/BWTECH-github/owncloud.online.git market
cd market
composer install --no-dev
sudo chown -R www-data:www-data .
sudo -u www-data php /var/www/owncloud/occ app:enable market

If you prefer the prebuilt artifact, download the latest release archive from the Releases page and extract it into apps/market/.

Configuration #

Everything is optional — out of the box the bundled local catalog at apps/market/marketplace/apps.json is used.

Add to config/config.php to change the source:

<?php
$CONFIG = [
    // (1) bundled catalog (default)              — `appstoreurl` unset or "local"
    // (2) catalog at a custom file-system path
    'appstoreurl' => 'file:///srv/owncloud-catalog',

    // (3) remote HTTPS marketplace (classic mode)
    // 'appstoreurl' => 'https://marketplace.owncloud.com',
    // 'marketplace.key' => 'your-api-key',
    // 'marketplace.ca' => '/etc/ssl/custom-ca.pem',

    // notification recipients
    // 'has_internet_connection' => true,  // disable to suppress remote calls
];

Adding your own app to the local catalog #

Edit marketplace/apps.json (see marketplace/README.md for the full schema):

[
  {
    "id": "myapp",
    "name": "My App",
    "summary": "One-line summary",
    "categories": ["tools"],
    "publisher": { "name": "Me", "url": "https://example.com", "isPagePublic": true },
    "downloadable": true,
    "screenshots": [{ "url": "https://example.com/myapp.png" }],
    "releases": [
      {
        "version": "1.0.0",
        "platformMin": "10",
        "platformMax": "10.99",
        "license": "AGPL-3.0",
        "download": "https://github.com/me/myapp/releases/download/v1.0.0/myapp-1.0.0.tar.gz"
      }
    ]
  }
]

Then click Clear cache in the Market sidebar — the new app appears immediately. The download URL can be HTTPS, a file:/// path, or a path relative to the catalog directory.

OCC commands #

Daily usage #

1. Open ownCloud and go to Apps → Market.
2. Use the search box at the top of the sidebar to find apps.
3. Click an app, then Install.
4. Updates appear under Updates in the sidebar with a counter badge; click an entry to read release notes and update.

The UI follows the operating-system colour scheme automatically — there's nothing to toggle for dark mode.

Troubleshooting #

Development #

make build-dev               # build JS bundle once
npm run dev                  # webpack --watch
make test-php-style          # php-cs-fixer dry-run
make test-php-unit           # phpunit

CI runs the same checks on every push and pull request — see .github/workflows/.

Attribution #

This is a fork of owncloud/market (© ownCloud GmbH, AGPL-3.0). Modifications by BW-Tech GmbH for owncloud.online. The licence remains AGPL-3.0.

License #

AGPL-3.0 — see LICENSE.