asciinema server on Ubuntu 24.04 LTS

Azure Developer Tools

asciinema server, a self hosted home for terminal session recordings that replay as real, selectable text rather than video

Base
Hardened build
minimal ports, security patches applied at build time
Access
Unique credentials
generated on first boot, readable only by root
Verified
Boots working
services pass a health gate before release
Support
24/7, 365 days
by email and live chat, 24 hour response SLA

Overview

asciinema server is the self hosted server half of the asciinema ecosystem. You record a terminal session with the asciinema command line tool, upload it to your own server, and get back a link that replays the session in a real terminal player: the text stays selectable and copyable, so a viewer can lift a command straight out of the playback instead of retyping what they see in a video.

Because a recording is stored as timed text rather than pixels, it stays small, it loads instantly, and the server can search the actual terminal content as well as titles and descriptions. Around that it gives you a browsable library with per recording visibility, secret sharing links, embeddable players, downloadable transcripts, live terminal streaming and an administration panel. It suits teams who want product demos, incident walkthroughs, onboarding material and support transcripts to live on infrastructure they control rather than a public service.

Why the cloudimg image

The cloudimg image is the whole appliance rather than the application alone: the upstream release pinned to an immutable image digest so the version never drifts, PostgreSQL co hosted on the same machine, and nginx already fronting the application as the only entry point. Recordings, the render cache and the database all sit on a dedicated, independently resizable data volume that is re provisioned with every instance. It is secure by default rather than open on arrival: upstream asciinema server hands administrator rights to the first account that registers and leaves public sign up open, so instead every launch closes sign up before the server accepts a single connection and claims the administrator account for itself during first boot, and the web front door stays shut until that lock down has completed. A unique session signing key, database password and command line upload token are generated per instance and written to a root only file, so no two deployments share a secret. Each instance learns its own address on first boot, so the share links it hands back to the command line tool are correct and reachable immediately, and because no mail relay is needed a root only helper mints a fresh sign in link on demand. The upstream administration panel authenticates nobody on its own, so it is kept off the network entirely and reached only behind an administrator session. Every image comes with a step by step deployment guide written and executed against the running product, and 24/7 support from cloudimg.

Common uses

  • Keep product demos, onboarding walkthroughs and incident write ups as replayable terminal sessions your team owns
  • Share a command sequence as a link whose text viewers can select and copy, instead of a screen recording
  • Run a private upload target for the asciinema command line tool so no session transcript leaves your infrastructure

See it running

Real screenshots taken while testing this image against its deployment guide.

asciinema server on Ubuntu 24.04 LTS screenshot 1 asciinema server on Ubuntu 24.04 LTS screenshot 2 asciinema server on Ubuntu 24.04 LTS screenshot 3 asciinema server on Ubuntu 24.04 LTS screenshot 4