Skip to content

Upgrading

To upgrade your instance of asciinema server to the latest version:

  • check the releases for the latest version number
  • check the release notes of all versions between the one you're running and the one you're upgrading to, and look for manual upgrade steps and breaking changes for each version - if there are manual steps you omit you may end up with a broken installation,
  • update the asciinema container image tag to the latest number
  • recreate the stack by running docker compose up -d

Release notes for each version include detailed information on the steps needed for a successful upgrade. Backward compatibility is always a high priority when cutting a new release, thus, breaking changes are more the exception than the rule.

Usually, it's a matter of updating the container image tag:

docker-compose.yml
 services:
   asciinema:
-    image: ghcr.io/asciinema/asciinema-server:20240324
+    image: ghcr.io/asciinema/asciinema-server:20240428
     # ...

Then executing docker compose up -d.