March 2024 status


screenshot of customized CryptPad instance

CryptPad Spring release (2024.3.0)

At the time of writing the latest CryptPad release is in production on CryptPad.fr and will soon be tagged on GitHub.

This is a major release since it changes the way CryptPad is installed with potential breaking changes for existing instances. Instead of going from 5.7.0 to 6.0.0, we are taking this opportunity to make a change to our version numbering. As CryptPad keeps growing and developing the accumulation of numbers in versions 5.x.x, 6.x.x, … is starting to feel arbitrary. Instead we would like to reflect that CryptPad is an ongoing project being actively maintained and improved for the foreseeable future. As a self-hostable service we believe a date-based version is also a benefit for users as it provides a quick way of checking how up-to-date a particular instance is before using it.

We are moving from semantic versioning (semver e.g. 5.7.0) to calendar versioning with each release carrying a date stamp rather than an iteration count. The first of these releases is 2024.3.0 and we will continue in the YYYY.MM.micro format after that. Combined with the quarterly release schedule in place since ~1 year, this means you can expect the following versions of CryptPad this year:

  • Spring 2024.3.0
  • Summer 2024.6.0
  • Autumn 2024.9.0
  • ❄️ Winter 2024.12.0

In between these milestones we could issue patch releases if needed for urgent bug fixes or security. These would look like 2024.3.1, 2024.3.2, etc. Note that this new scheme is still compatible with semver, only it jumps 2018.3 versions from 5.7.0 to 2023.3.0 in one go.

Besides these technicalities, there are also some great new features in the 2024 Spring release, mainly aimed at instance administrators:

️ Refactored admin panel

We have revamped the administration panel which now uses a more streamlined component system. This should make for more consistent and maintainable styles in that section. We have also re-organized the tabs so that important information about the instance (name, description, etc) is presented first.

Easily customize instance logo and accent color

It is now possible to add a custom logo to a CryptPad instance from the admin panel. The accent color (used in buttons and many other parts of the CryptPad UI) can also be changed to match the logo or branding.

We ensure that the color used by default has sufficient contrast with text and background colors in both dark and light themes. Making this customizable will potentially create less accessible color combinations, so we urge administrators to check color contrast before choosing a new color. We will do our best to monitor how this feature is used and potentially add measures such as a contrast-checker in a future version.

‍⚕️ New help-desk system

The support system has been completely refactored to make it easier to manage a large history of tickets (serving our own needs on CryptPad.fr). Crucially this new version now includes a new "moderator" role for users that can access the support system without having admin rights on the instance.

New external module for OnlyOffice applications

As you may know, the Spreadsheet, Document, and Presentation applications are integrations of OnlyOffice editors with CryptPad's end-to-end encrypted real-time collaboration. Until now all 6 versions of OnlyOffice since we started integrating it were included in the CryptPad repository. On CryptPad.fr we need to keep all of these versions to support opening documents that our users may have created a long time ago. For newer instances however, it makes little sense to download 1.7GB of OnlyOffice versions that will never be used.

With this version we are taking the first step in taking the OnlyOffice builds out of the main CryptPad code-base to their own repository. We provide an installation script for instance admins to easily install the apps if they want to. While this is "all 6 historical versions or nothing" for now, it is the first step towards a finer-grained system where each instance only downloads the OnlyOffice version currently in use and any subsequent updates.

up next

  • We have started correcting a few issues with 2024.3.0 after putting it to the test of production
  • We hope to officially release this version next week
  • After this we will start planning for the Summer release (2024.6.0)
  • We already said this last time but we are closer than ever to wrapping up our two NGI projects AUTH and BLUEPRINTS and to releasing our Cryptography R&D website