Skip to Content
Administration GuideMigrations

Migrations & Updates

2026-05-15: oarepo-app v4.0.0 CCMM extra

oarepo-app ≥ 4.0.0RDM v14

In oarepo-app v4.0.0, CCMM dependencies were moved to a separate optional dependency extra. Repositories that use CCMM must enable the ccmm extra explicitly.

AffectedNot affected
Repositories using CCMMRepositories not using CCMM
Repositories upgrading to oarepo-app >= 4.0.0Repositories using older oarepo-app versions
Show migration steps

Update pyproject.toml

In pyproject.toml, update the oarepo-app dependency extra from production to production,ccmm.

Before:

dependencies = [
    "oarepo-app[production]==4.0.0",
]

After:

dependencies = [
    "oarepo-app[production,ccmm]==4.0.0",
]

Run ./run.sh upgrade to update the lock file.

2026-05-11: oarepo-app v2.3.0

oarepo-ui PR #21oarepo-app ≥ 2.3.0RDM v14

This breaking change introduces the oarepo-app library in version 2.3.0. This release includes all Invenio changes released before 2026-05-01, including the introduction of CCMM vocabularies.

AffectedNot affected
Repositories created before 2026-05-11Repositories created after 2026-05-11
Repositories using oarepo-app <= 2.3.0, or not using oarepo-app at all---
Show migration steps

Update pyproject.toml

  1. In pyproject.toml, remove all oarepo-* dependencies and replace them with the new oarepo-app library. Do not remove the oarepo[s3,rdm] dependency.

Before:

dependencies = [
        "oarepo[s3,rdm]>=14.0.0,<14.1.9",
        "oarepo-runtime>=2.0.0dev0,<3.0.0",
        "oarepo-ui>=7.0.0dev0,<8.0.0",
        ...
]

After:

dependencies = [
    "oarepo[s3,rdm]>=14.2.1b10.dev6,<15.0.0",
    "oarepo-app[production]==2.3.0",  # <---- here
]
  1. Update the version of the oarepo library:
dependencies = [
    "oarepo[s3,rdm]>=14.2.1b10.dev6,<15.0.0",  # <---- here
    "oarepo-app[production]==2.3.0",
]
  1. Make sure you use Python 3.14 in the requires-python section.
requires-python = ">=3.14,<3.15"

  1. Remove the top-level package.json if it exists.

  2. Run ./run.sh upgrade to update the lock file.

  3. Run ./run.sh reset to reset your local instance because of the CCMM vocabularies.

  4. If you have sample data, you will need to update it to use CCMM vocabularies. See your https://127.0.0.1:5000/vocabularies which values are permitted.

    For example:

    1. Change the resource type ID from dataset to c_ddb1.
    2. Change the created time reference to Created (capitalized first letter).
    3. Change the cc0-1.0 license to CC0-1.0 (capitalized CC).

For inspiration, see invenio-fzu PR #22 

If you are already running a production instance, please contact us first.

Make sure you have run the older migrations first.

2026-02-18: oarepo-ui v7.0+ Required Base Templates

oarepo-ui PR #409oarepo-ui ≥ 7.0RDM v14

oarepo-ui v7.0+ package requires base template files in your model’s UI module. These templates must extend the oarepo-ui base templates. See Record landing page documentation for the complete template inheritance flow.

AffectedNot affected
Model UIs created before 2026-02-18Model UIs generated after 2026-02-18
Using default templatesCustom page templates configured
oarepo-ui >= 7.0older versions
Show migration steps

Option 1: Use model update (Recommended)

Run the model update command from your repository root:

./run.sh model update <model_name>

Option 2: Create files manually

If you prefer not to use model update, you can create the required template files manually in ui/mymodel/templates/semantic-ui/mymodel/. See the model copier template  for the complete list of required files.

Common issues:

  • TemplateNotFound: mymodel/record_detail.html → Create base template file
  • Partials not showing → Check that mymodel/record_detail/main.html exist
Last updated on
Overview