Skip to main content

App Versions

Install any earlier or newer version of already installed Nextcloud apps. Essential for debugging, testing compatibility, and recovering from a breaking change in a minor release.

Status: in development. This documentation site is up so the brand surface and the eventual journeydoc tutorials have a stable home. Step-by-step walkthroughs and screenshots land as the admin UI matures. Follow the GitHub repository for milestones.

What does it do?​

App Versions gives Nextcloud admins a version picker over every installed app, with three things working together:

  • Multi-source. App Versions queries the Nextcloud App Store and, per app, optionally a GitHub releases endpoint — public or, with a stored personal access token, private. The version list is merged and labelled by origin.
  • Rollback or pin. Picking a version replaces the currently installed one. That works in both directions: roll back to a known-good release after an update breaks production, or pin to a newer release candidate to test compatibility before the rest of the fleet catches up.
  • Audit-trailed. Every install, downgrade, or pin is logged with who, what, and when — so a Friday-evening rollback by an on-call admin is visible Monday morning without digging through server logs.

The app is built around four specs (see the openspec tracker on GitHub):

  • version-management — list installed apps, pick a version, install.
  • external-sources — GitHub releases as a source alongside the App Store.
  • pat-management — encrypted PAT storage for private GitHub repos.
  • app-discovery — a single search aggregator over the App Store, your PAT-visible repos, and (opt-in) public GitHub topic search.

Getting started​

The admin UI is being built. Once the first usable build is tagged, the tutorials below will be filled in — they are placeholders today, marked clearly as such.

  • Setting things up? The Admin guide will cover the first launch, picking a version, and connecting a GitHub release source.
  • Curious how it works at the API level? The specs linked above are the source of truth while the user-facing documentation catches up.

Free and open source under the AGPL-3.0-or-later license. For support, contact support@conduction.nl.