Record and share your terminal sessions, the right way.
asciinema is a free and open source solution for recording terminal sessions and sharing them on the web.
Below you'll find setup instructions in case you want to contribute, play with it on your local machine, or setup your own instance for private use or for your organization.
Quickstart Using Docker Compose
$ wget https://raw.githubusercontent.com/asciinema/asciinema.org/master/docker-compose.yml $ docker-compose up -d asciinema $ docker-compose run --rm db_init
You can override the address/port that is sent in email with login token by passing HOST="host:port" environment variable when starting the web server.
Assuming you are running Docker Toolbox and VirtualBox: go to http://192.168.99.100:3000/ and enjoy.
1. Install dependencies
asciinema.org site is a Ruby on Rails application. You need to have following dependencies installed:
Ruby 2.0+ (Ruby 2.1 is recommended)
gem install bundler
PostgreSQL 8+ with libpq development headers
sudo apt-get install postgresql libpq-devon Debian/Ubuntu
asciinema's libtsm fork (
See here for installation instructions. If you don't install it now the setup script (point 4 below) will try to install it for you anyway.
sudo add-apt-repository ppa:tanguy-patte/phantomjs && sudo apt-get update && sudo apt-get install phantomjs
2. Get the source code
Clone git repository:
$ git clone git://github.com/asciinema/asciinema.org.git $ cd asciinema.org
3. Prepare database config file
Copy config/database.yml.example to config/database.yml. Then set database/user/password to whatever you prefer.
If database specified in database.yml doesn't exist then the following setup task will create it (make sure database user is allowed to create new databases).
4. Setup the app
Following script will install gem dependencies and setup database:
5. Run Rails server
$ bundle exec rails server
6. Run the background job processor
The background job processor is needed for asciicast pre-processing and thumbnail generation.
$ bundle exec sidekiq
If you want to contribute to this project check out Contributing page.
Copyright © 2011-2016 Marcin Kulik. See LICENSE.txt for details.