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.