Skip to content


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:

-    image:
+    image:
     # ...

Then executing docker compose up -d.