asciinema server is self-hosting friendly, and can be deployed both for public or internal/private use in any containerized environment using the official OCI image, ghcr.io/asciinema/asciinema-server.
- OCI runtime, e.g. Docker, Podman, Kubernetes
- 512 MB of RAM minimum (for a personal instance), 1 GB recommended (for a community/company instance)
- PostgreSQL 14.0+ database server
- SMTP server, either a dedicated service or an SMTP endpoint of your email provider
To get started, follow the quick start guide, which provides a template for a standard asciinema server configuration using docker-compose. This configuration includes a PostgreSQL container and supports HTTPS, allowing you to set up a complete, secure asciinema server easily.
Once your server is up and running, you'll be able to upload your recordings by
pointing asciinema CLI to the server using the
ASCIINEMA_API_URL environment variable:
asciinema upload demo.cast
Last but not least, if your company is interested in having the installation, maintenance or customization of the server performed by the people who created asciinema, then check out asciinema consulting services.