Repository navigation
Releases
v22.0.4
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 launchon clusters whose storage provisioner does not supportfsGroup, such as Minikube or kind; it is a no-op on clusters wherefsGroupalready works. Air-gapped clusters must now also mirror theopenedx-permissionsimage for Kubernetes deployments, not only fortutor local; mirror it by digest or with a tool that preserves thesecurity.capabilityxattr, 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
--alloption totutor mounts removeto remove all bind-mounts at once. (by @valkrypton) -
[Security] Upgrade
OPENEDX_COMMON_VERSIONtorelease/verawood.2, which includes several security fixes. Verawood.2 moves Studio library content to a separatestudio_library_contentMeilisearch index: on existing platforms, this index is populated by thereindex_studiocommand that runs duringtutor local/k8s launch(ordo 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 foundwhen 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
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_VERSIONtorelease/ulmo.5, which includes several security fixes. (by @Abdul-Muqadim-Arbisoft)
v22.0.3
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
FEATURESdict entries, which edx-platform no longer reads from downstream settings modules. Rebind theFEATURESproxy in Tutor's settings modules, so that plugins which still assign toFEATURES["..."]keep working. (by @arbrandes) -
[Bugfix] Remove the
ENABLE_COURSEWARE_MICROFRONTEND = Falseoverride 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.0constraint and require click>=8.4. The crash that motivated the pin ("expected string or bytes-like object, got 'Sentinel'" ontutor 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_MEILISEARCHisfalsewhileMEILISEARCH_URLis still set to its default value. (by @fghaas) -
[Bugfix] Mount the
openedx-mediaandopenedx-media-privatevolumes in thelms-jobandcms-jobservices, like in thelmsandcmsservices. Files written by jobs to the media folders were lost when the job container was removed: for instance,importdemocourseleft the demo course with video transcripts whose files did not exist, so that transcript requests failed with a 500 error. Runningimportdemocourseagain does not repair an existing demo course, because the transcript records already exist: delete the demo course (or itsedxvalVideoTranscriptrecords) 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
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
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
setuptoolsin pip's isolated build environments, so that pip 26 can still build source packages such asloremipsum. Backport of #1411. (by @ahmed-arb)
v22.0.2
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
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.5field emitted by hatchling 1.32.0. (by @Abdul-Muqadim-Arbisoft)
v22.0.0
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-pythonto>= 3.10. Usesphinx>=9.1.0for Python 3.14+ andsphinx>=7.4.7for 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
setuptoolsto 80.9.0 (the release branch keeps 69.1.1). The older version cannot build packages that declare their license with the PEP 639project.licensefield (e.g.mysqlclient) against the Open edX master branch, which broketutor images build openedxon 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
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
setuptoolsused inside the isolated PEP 517 build environments that uv/pip create when building Python packages from source. Previously the latestsetuptoolswas fetched to build every sdist regardless of the version installed in the venv, which made builds non-reproducible and broke them whensetuptools81 removedpkg_resources(e.g. when buildingloremipsum, a transitive dependency ofedx-ora2). The constraint is set viaUV_BUILD_CONSTRAINT/PIP_CONSTRAINTin 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
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
- These smoke tests check for the following basic necessities:
-
[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.