Plugins #

owncloud.online consists of a core and apps. Some of these apps are part of the server and ship with it, such as files, sharing, deleted files, versions and DAV. Everything else is a plugin: an app that is maintained and versioned on its own and that you install, update and remove through the Marketplace without replacing the server. The details are in Managing apps.

Overview #

Every app has its own page with requirements, installation and setup.

Security and login #

Data protection #

Files and storage #

Collaboration and office #

Administration and tools #

Plugins during a server update #

During a server update, the risk is not the core but the plugins: an app that no longer fits the new server version stops the update. That is why occ upgrade first runs the step Upgrade app code from the marketplace. It sorts all installed apps into three groups (compatible, incompatible, missing: directory gone, database entry still there) and then tries to bring them to a matching version through the Marketplace, in the order incompatible, missing, compatible.

What happens next depends on the result:

• If an incompatible or missing app is left over, the update stops ("Upgrade is not possible"). Before that, the output lists every affected app with the matching occ app:disable command. Work through the list and run occ upgrade again.
• If a compatible app could not be updated, the update continues; the output says "App was not updated: …".

On a minor server update, the server does not move apps to a new major version on its own. If you want that:

sudo -u www-data php8.4 occ upgrade --major

Two things that are easy to miss during an update:

• apps-external/ is part of the code tree, not of the data directory. A backup of the data directory therefore does not contain the plugins you installed, see Moving to another server.
• If the directory of an app that is already loaded is replaced with a newer version while the server is running, occ itself can no longer start. Turn on maintenance mode before you swap the directory, see Backups and updates.

Settings in config.php #

Set and check them like any other system key:

sudo -u www-data php8.4 occ config:system:set appstoreurl \
  --value https://market.example.com
sudo -u www-data php8.4 occ config:system:get appstoreurl

Troubleshooting #

If the cause is still unclear, check the server log, see Server log and error messages.

Reporting a problem #

Report problems with the server itself or with the Market app at https://github.com/BWTECH-github/owncloud.online/issues. For all other plugins, especially apps that require an API key, contact BW-Tech GmbH support (https://bw.tech).

A useful report contains:

# server version
sudo -u www-data php8.4 occ status

# version and state of the affected app
sudo -u www-data php8.4 occ app:list

# system configuration; sensitive values are replaced with a placeholder
# (only --private would show them in plain text)
sudo -u www-data php8.4 occ config:list system

Add the server log entries from the time of the error (Server log and error messages) and the steps that reproduce the problem.