Skip to content

Software Versions

Gibran Khan edited this page Nov 18, 2026 · 3 revisions

Software versions

Stable v1.0.1 release.

Choose versions

For a new installation, open Identity and software → Advanced software settings. Choose the package repository branch (latest or quarterly), then edit Nextcloud, PHP and MariaDB together on one form. Defaults remain Nextcloud major 35, PHP 8.5 and MariaDB 12.3.

Field Input example What it requests
Nextcloud 36 Newest stable release in the 36.x series
Nextcloud 36.0 Newest stable 36.0.x release
Nextcloud 36.0.1 That exact stable release, even if a newer patch exists
PHP 8.6 php86 and matching PHP modules
MariaDB 11.4 mariadb114-server and mariadb114-client

These examples show valid input; they do not guarantee availability or compatibility. PHP and MariaDB fields select package flavours. Native pkg chooses their current package versions and dependencies from the selected branch. Apache24 is fixed. These choices do not migrate an existing installation.

Any valid numeric selection can be requested. The installer attempts it using the existing installation procedure, native pkg and Nextcloud occ. Download, package, Nextcloud and integration failures are reported; the installer does not fall back to other versions or silently substitute them.

Read the software review

The review compares the resolved Nextcloud release and selected PHP/MariaDB flavours with resources/tested-versions.json.

Record status What you see
One or more selections are not recorded WARNING naming them
All are recorded individually, but the combination is not INFO: exact combination not recorded
The exact combination is recorded INFO: recorded as a tested combination

These messages do not block installation. Individually recorded versions do not mean their combination was tested.

Warnings appear before APPLY, including with --yes. No extra override is needed. --yes approves APPLY; timed KEEP is still required.

Edit the tested-version register

Edit resources/tested-versions.json to record confirmed versions and optional tested combinations. No Python changes are needed. Its current contents are:

{
  "schema_version": 1,
  "tested_versions": {
    "nextcloud": ["35.0.3"],
    "php": ["8.5"],
    "database": ["12.3"]
  },
  "tested_combinations": [
    {
      "nextcloud": "35.0.3",
      "php": "8.5",
      "database": "12.3"
    }
  ]
}
  • After confirming another version works, append its string to the appropriate tested_versions array. Nextcloud entries are exact three-part stable releases; PHP and MariaDB entries are major.minor package flavours.
  • Add a complete tested_combinations entry only for a combination you have tested. This section can be empty or omitted; every possible combination need not be listed.
  • A combination also counts as an individual record for each member, so those values need not be repeated in the individual arrays.

The file changes only review messages. Defaults are set in resources/versions.json. Edit the copy intended for new installations. Keep existing instances' retained installers and saved configurations unchanged for Resume and Verify.

Use the same choices in a recipe

Set the family fields in your own recipe, for example:

{"version_families": {"nextcloud": "36.0", "php": "8.6", "database": "11.4"}}

For an exact release, use "nextcloud_exact": "36.0.1" and omit the Nextcloud family. Remove an old nextcloud_min if it conflicts with your choice. The wizard clears that minimum when you change Nextcloud; contradictory recipe settings are rejected.

For complete recipes and installation steps, see the recipe guide or installation guide.

Clone this wiki locally