asciinema.org/docs/INSTALL.md

asciinema web app install guide

Quickstart Using Docker Compose

Required:

• Docker
• docker-compose 1.5+

$ wget https://raw.githubusercontent.com/asciinema/asciinema.org/master/docker-compose.yml
$ docker-compose run --rm db_init
$ docker-compose up -d web

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://your-docker-host:3000/ and enjoy.

Manual setup

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)

• bundler gem
  gem install bundler

• PostgreSQL 8+ with libpq development headers
  sudo apt-get install postgresql libpq-dev on Debian/Ubuntu

• asciinema's libtsm fork (asciinema branch)
  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.

• phantomjs 2.0+
  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:

$ ./script/setup

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

Using asciinema recorder with your instance

Once you have your instance running, point asciinema recorder to it by setting API URL in ~/.config/asciinema/config file as follows:

[api]
url = https://your.asciinema.host