Skip to content

Releases

v22.0.4

Choose a tag to compare

@github-actions github-actions released this 03 Nov 14:42
bca91d5

Install this version from pip with:

pip install "tutor[full]==22.0.4"

Or download the compiled binaries:

sudo curl -L "https://github.com/overhangio/tutor/releases/download/v22.0.4/tutor-$(uname -s)_$(uname -m)" -o /usr/local/bin/tutor
sudo chmod 0755 /usr/local/bin/tutor

See the installation docs for more installation options and instructions.

Changes

  • [Bugfix] Add an init container to the MongoDB, MySQL, Redis and Meilisearch Kubernetes deployments (unconditionally, on every cluster) that fixes volume ownership before the main container starts. This fixes a crash on first tutor k8s launch on clusters whose storage provisioner does not support fsGroup, such as Minikube or kind; it is a no-op on clusters where fsGroup already works. Air-gapped clusters must now also mirror the openedx-permissions image for Kubernetes deployments, not only for tutor local; mirror it by digest or with a tool that preserves the security.capability xattr, since the image's non-root init container relies on a file capability that some image re-layering tools silently strip, which would quietly bring back the original crash. (by @Syed-Ali-Abbas-568)

  • [Feature] Add a --all option to tutor mounts remove to remove all bind-mounts at once. (by @valkrypton)

  • [Security] Upgrade OPENEDX_COMMON_VERSION to release/verawood.2, which includes several security fixes. Verawood.2 moves Studio library content to a separate studio_library_content Meilisearch index: on existing platforms, this index is populated by the reindex_studio command that runs during tutor local/k8s launch (or do init). Library search in the Authoring MFE requires an MFE image built from Verawood.2, so also upgrade tutor-mfe. (by @Abdul-Muqadim-Arbisoft)

  • [Bugfix] Fix ImportError: ... GLIBC_2.38 not found when compiling assets in the openedx image, after an image of a Tutor release based on a newer Ubuntu was built on the same machine. The uv cache is now separate for each Ubuntu version. (by @ahmed-arb)

v21.0.11

Choose a tag to compare

@github-actions github-actions released this 02 Nov 16:17
a43a4c9

Install this version from pip with:

pip install "tutor[full]==21.0.11"

Or download the compiled binaries:

sudo curl -L "https://github.com/overhangio/tutor/releases/download/v21.0.11/tutor-$(uname -s)_$(uname -m)" -o /usr/local/bin/tutor
sudo chmod 0755 /usr/local/bin/tutor

See the installation docs for more installation options and instructions.

Changes

  • [Security] Upgrade OPENEDX_COMMON_VERSION to release/ulmo.5, which includes several security fixes. (by @Abdul-Muqadim-Arbisoft)

v22.0.3

Choose a tag to compare

@github-actions github-actions released this 27 Oct 08:47
d823966

Install this version from pip with:

pip install "tutor[full]==22.0.3"

Or download the compiled binaries:

sudo curl -L "https://github.com/overhangio/tutor/releases/download/v22.0.3/tutor-$(uname -s)_$(uname -m)" -o /usr/local/bin/tutor
sudo chmod 0755 /usr/local/bin/tutor

See the installation docs for more installation options and instructions.

Changes

  • [Feature] Added llms.txt file (by @muhammadadeeltajamul)

  • [Bugfix] Set feature toggles as flat Django settings instead of FEATURES dict entries, which edx-platform no longer reads from downstream settings modules. Rebind the FEATURES proxy in Tutor's settings modules, so that plugins which still assign to FEATURES["..."] keep working. (by @arbrandes)

  • [Bugfix] Remove the ENABLE_COURSEWARE_MICROFRONTEND = False override from the LMS development settings. (by @arbrandes)

  • [Bugfix] Make the MySQL init job tolerate CREATE USER IF NOT EXISTS failing with "referenced as a definer account in a view" (MySQL bug 107139). This happens on managed databases where the admin user lacks SET_USER_ID (MySQL 8.0) or ALLOW_NONEXISTENT_DEFINER (MySQL 8.4) once edx-enterprise has created its view. (by @Kelketek)

  • [Bugfix] Remove the temporary click<8.3.0 constraint and require click>=8.4. The crash that motivated the pin ("expected string or bytes-like object, got 'Sentinel'" on tutor dev launch) was a click 8.3.0 bug that was fixed upstream in click 8.3.1. (by @ahmed-arb)

  • [Improvement] Warn the user when RUN_MEILISEARCH is false while MEILISEARCH_URL is still set to its default value. (by @fghaas)

  • [Bugfix] Mount the openedx-media and openedx-media-private volumes in the lms-job and cms-job services, like in the lms and cms services. Files written by jobs to the media folders were lost when the job container was removed: for instance, importdemocourse left the demo course with video transcripts whose files did not exist, so that transcript requests failed with a 500 error. Running importdemocourse again does not repair an existing demo course, because the transcript records already exist: delete the demo course (or its edxval VideoTranscript records) first, then import it again. (by @Faraz32123)

  • [Security] Upgrade certifi, pip, uv and Node.js (v24) in the Open edX image, and Caddy, to stop trusting the compromised eMudhra/emSign CA certificates. See #1515. (by @ahmed-arb)

v21.0.10

Choose a tag to compare

@ahmed-arb ahmed-arb released this 27 Oct 10:57
48f08a1

Install this version from pip with:

pip install "tutor[full]==21.0.10"

Or download the compiled binaries:

sudo curl -L "https://github.com/overhangio/tutor/releases/download/v21.0.10/tutor-$(uname -s)_$(uname -m)" -o /usr/local/bin/tutor
sudo chmod 0755 /usr/local/bin/tutor

See the installation docs for more installation options and instructions.

Changes

  • [Security] Upgrade certifi, pip, uv and Node.js (v24) in the Open edX image, and Caddy, to stop trusting the compromised eMudhra/emSign CA certificates. See #1515. (by @ahmed-arb)

v20.0.6

Choose a tag to compare

@ahmed-arb ahmed-arb released this 27 Oct 10:57
28321e7

Install this version from pip with:

pip install "tutor[full]==20.0.6"

Or download the compiled binaries:

sudo curl -L "https://github.com/overhangio/tutor/releases/download/v20.0.6/tutor-$(uname -s)_$(uname -m)" -o /usr/local/bin/tutor
sudo chmod 0755 /usr/local/bin/tutor

See the installation docs for more installation options and instructions.

Changes

  • [Security] Upgrade certifi, pip and Node.js (v22) in the Open edX image, and Caddy, to stop trusting the compromised eMudhra/emSign CA certificates. See #1515. (by @ahmed-arb)

  • [Bugfix] Pin setuptools in pip's isolated build environments, so that pip 26 can still build source packages such as loremipsum. Backport of #1411. (by @ahmed-arb)

v22.0.2

Choose a tag to compare

@github-actions github-actions released this 31 Aug 11:33
d452f0d

Install this version from pip with:

pip install "tutor[full]==22.0.2"

Or download the compiled binaries:

sudo curl -L "https://github.com/overhangio/tutor/releases/download/v22.0.2/tutor-$(uname -s)_$(uname -m)" -o /usr/local/bin/tutor
sudo chmod 0755 /usr/local/bin/tutor

See the installation docs for more installation options and instructions.

Changes

[Bugfix] Fix LMS init job failure when MONGODB_HOST contains comma-separated replica set members. (by @carlos-marquez-wgu)

v22.0.1

Choose a tag to compare

@github-actions github-actions released this 13 Aug 08:33
9357287

Install this version from pip with:

pip install "tutor[full]==22.0.1"

Or download the compiled binaries:

sudo curl -L "https://github.com/overhangio/tutor/releases/download/v22.0.1/tutor-$(uname -s)_$(uname -m)" -o /usr/local/bin/tutor
sudo chmod 0755 /usr/local/bin/tutor

See the installation docs for more installation options and instructions.

Changes

  • [Security] Move secure cookie configuration to the common production settings so it applies to both LMS and CMS. (by @jfavellar90)

  • [Bugfix] Bump twine to 7.0.0 so that the Python package can be checked and published again. Older twine versions rejected the Metadata-Version: 2.5 field emitted by hatchling 1.32.0. (by @Abdul-Muqadim-Arbisoft)

v22.0.0

Choose a tag to compare

@github-actions github-actions released this 06 Aug 13:26
f3a8a47

Install this version from pip with:

pip install "tutor[full]==22.0.0"

Or download the compiled binaries:

sudo curl -L "https://github.com/overhangio/tutor/releases/download/v22.0.0/tutor-$(uname -s)_$(uname -m)" -o /usr/local/bin/tutor
sudo chmod 0755 /usr/local/bin/tutor

See the installation docs for more installation options and instructions.

Changes

  • [Feature] Add ENV_SAVED Action that allows hooks to run after a save
    operation. (by @xitij2000)

[Improvement] Update to use Python 3.12 for edx-platform

  • 💥[Improvement] Add Python 3.13 and 3.14 support. Drop Python 3.9 (end-of-life). Update CI matrix from Python 3.9/3.12 to 3.10/3.14. Update requires-python to >= 3.10. Use sphinx>=9.1.0 for Python 3.14+ and sphinx>=7.4.7 for Python 3.10 to account for Sphinx 9.x dropping Python 3.10 support. (by @Syed-Ali-Abbas-568)

  • 💥[Feature] Upgrade to Verawood. (by @ahmed-arb)

  • [Improvement] Upgrade Caddy to v2.11.4 and Redis to v7.4.9. (by @ahmed-arb)

  • [Improvement] Upgrade Python to v3.12.13 and Node.js to v24.16.0 in the Open edX Docker image. (by @ahmed-arb)

  • [Security] Upgrade MongoDB to v7.0.35 to pull in upstream security patches, remaining on the 7.0 line that Open edX tests against. (by @ahmed-arb)

  • [Improvement] Upgrade MySQL to v8.4.9, the latest patch on the 8.4 LTS line. (by @ahmed-arb)

  • [Bugfix] On the main branch, bump the pinned build-time setuptools to 80.9.0 (the release branch keeps 69.1.1). The older version cannot build packages that declare their license with the PEP 639 project.license field (e.g. mysqlclient) against the Open edX master branch, which broke tutor images build openedx on main. (by @Abdul-Muqadim-Arbisoft)

  • [Improvement] Run smoke workflows on Python 3.10 instead of 3.9 as it has reached EOL. (by @Danyal-Faheem)

  • 💥[Improvement] Upgrade Meilisearch to v1.36.0. This changes the on-disk index format, so v1.36.0 refuses to start on a database created by v1.8.4: the container restart-loops with a "database version (1.8.4) is incompatible with your current engine version (1.36.0)" error. Meilisearch is only a derived index in Open edX and never a source of truth, so the existing index must be discarded and rebuilt after upgrading. Stop the platform, delete data/meilisearch/data.ms, then re-run initialisation and reindex: (by @HammadYousaf01)

    tutor local stop
    rm -rf "$(tutor config printroot)/data/meilisearch/data.ms"
    tutor local start -d
    tutor local do init
    tutor local exec cms ./manage.py cms reindex_studio
    tutor local exec cms ./manage.py cms reindex_course --active
    
  • On a large site, the reindex takes a while and search stays incomplete until it finishes, so plan a maintenance window.

  • Rolling back is not just reverting the image tag. Because the format only moves forward, v1.8.4 cannot read a v1.36.0 database either, so you also need to restore your pre-upgrade data/meilisearch/data.ms backup.

  • [Improvement] Upgrade MySQL from 8.4.9 to 8.4.11. (by @github-actions[bot])

  • [Improvement] Upgrade MongoDB from 7.0.35 to 7.0.39. (by @github-actions[bot])

  • [Improvement] Upgrade Redis from 7.4.9 to 7.4.10. (by @github-actions[bot])

v21.0.9

Choose a tag to compare

@github-actions github-actions released this 04 Aug 11:33
9172ae5

Install this version from pip with:

pip install "tutor[full]==21.0.9"

Or download the compiled binaries:

sudo curl -L "https://github.com/overhangio/tutor/releases/download/v21.0.9/tutor-$(uname -s)_$(uname -m)" -o /usr/local/bin/tutor
sudo chmod 0755 /usr/local/bin/tutor

See the installation docs for more installation options and instructions.

Changes

  • [Improvement] Add a weekly GitHub Actions workflow to automatically open PRs when pinned Docker image dependencies (Caddy, MySQL, MongoDB, Redis) fall behind their latest patch release, and a Dependabot configuration to keep GitHub Actions, Dockerfiles, and Python requirements up to date. (by @Danyal-Faheem)

  • [Bugfix] Pin the build-time setuptools used inside the isolated PEP 517 build environments that uv/pip create when building Python packages from source. Previously the latest setuptools was fetched to build every sdist regardless of the version installed in the venv, which made builds non-reproducible and broke them when setuptools 81 removed pkg_resources (e.g. when building loremipsum, a transitive dependency of edx-ora2). The constraint is set via UV_BUILD_CONSTRAINT/PIP_CONSTRAINT in the base image stage, so it applies to all requirement installs (base.txt, assets.txt, development.txt, extra requirements and editable installs). (by @Abdul-Muqadim-Arbisoft)

  • [Feature] Upgrade OPENEDX_COMMON_VERSION to release/ulmo.4 (by @ahmed-arb)

v21.0.8

Choose a tag to compare

@github-actions github-actions released this 23 Jun 17:06
2d6faeb

Install this version from pip with:

pip install "tutor[full]==21.0.8"

Or download the compiled binaries:

sudo curl -L "https://github.com/overhangio/tutor/releases/download/v21.0.8/tutor-$(uname -s)_$(uname -m)" -o /usr/local/bin/tutor
sudo chmod 0755 /usr/local/bin/tutor

See the installation docs for more installation options and instructions.

Changes

  • [Feature] Persist lms and cms job logs (by @muhammadadeeltajamul)

  • [Bugfix] Compatibility with Fedora/SELinux systems: volume bind-mounts must indicate that they are shared between different containers. Otherwise, SELinux fails to mount them. (by @regisb)

  • [Improvement] Add a manually executable GitHub Action workflow to create version bump PRs for Major and Minor releases. (by @Danyal-Faheem)

  • [Feature] Add a TESTS filter to tutor to include smoke/integration tests for tutor core and plugins. (by @danyal Faheem)

  • [Feature] Add a new tutor local do tests <suite> --limit <service> command to run tests aggregated across tutor core and plugins using the TESTS filter. (by @Danyal-Faheem)

  • [Feature] Add idempotent smoke tests to quickly verify that a newly launched tutor instance is working. (by @Danyal-Faheem)

    • These smoke tests check for the following basic necessities:
      • User Management and Authentication
      • Course import, course creation
      • User enrollment
      • Basic healthchecks
      • OAuth Application creation
  • [Improvement] Add a manually executable ci workflow to verify launch and smoke tests for local and k8s environments. (by @Danyal-Faheem)

  • [Improvement] Unpin kubernetes<36 constraint as the upstream authentication bug has been resolved.