Self-hosted sites now tell you when an update is out

If you run Domma CMS on your own server, your admin now tells you when a new version is out, and what to run to update. Your Tools update from the Marketplace with a click.

By Darryl Waterhouse · · 2 min read

If you run Domma CMS on your own server, keeping it up to date is your job. Until now, nothing in your admin told you when a new version was out. From Domma CMS 1.43.0, it does.

A notice when there's a new version

Once a day, your site checks for the latest release of Domma CMS. When your site is behind, everyone with the Super Admin role gets one notification:

Domma CMS 1.44.0 is available This site runs Domma CMS 1.43.0. To update, run this in the site's folder: npx domma-cms@latest update

It appears in the bell at the top of your admin, like any other notification, with a link to Domma CMS on npm.

You only ever see one update notice at a time. If another release comes out before you've updated, the notice is replaced with the newer version. Once you've updated, it goes away.

Updating takes one command

Open a terminal in your site's folder and run:

npx domma-cms@latest update

To see what would change first, without changing anything, add --dry-run:

npx domma-cms@latest update --dry-run

The update replaces Domma's own files and the plugins that come with Domma CMS. Your pages, content, settings and your own plugins are left as they are. It backs up the files it replaces before it starts, so you can go back if you need to. What changed in each version is listed in CHANGELOG.md.

Your Tools update from the Marketplace

Tools you've bought from the Domma store have updates of their own. Your Marketplace shows which Tools have a newer version, and the Marketplace entry in your sidebar shows how many are waiting. Click Update on a Tool and your site downloads the new version, checks it is genuinely from Domma, and installs it over the old one, keeping all its data. If anything goes wrong, the old version is put back.

A Tool you've bought is yours to keep, and it carries on working for good. Updates come with it for as long as its support lasts. After that you can renew support with a one-off payment whenever you want the newer versions.

Turning the notice off

If you'd rather not hear about updates, open Notifications settings and switch off "Domma CMS update available". Or add "updateCheck": false to config/server.json, which stops the check altogether. If you turn it off while a notice is showing, that notice goes away too.

The check sends nothing about your site. It only asks npm for the newest version number.

If we host your site

Nothing changes for you. We update hosted sites ourselves, so they never show this notice.