117 lines
3.8 KiB
Markdown
117 lines
3.8 KiB
Markdown
# asciinema.org
|
|
|
|
[](https://travis-ci.org/asciinema/asciinema.org)
|
|
[](https://codeclimate.com/github/asciinema/asciinema.org)
|
|
[](https://coveralls.io/r/asciinema/asciinema.org)
|
|
|
|
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.
|
|
|
|
This is the source code of asciinema.org website. You can find asciinema's
|
|
terminal recorder at
|
|
[asciinema/asciinema](https://github.com/asciinema/asciinema) and asciinema
|
|
player at
|
|
[asciinema/asciinema-player](https://github.com/asciinema/asciinema-player).
|
|
|
|
## Setup instructions
|
|
|
|
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.
|
|
|
|
### Using Docker
|
|
|
|
```bash
|
|
$ docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=mypass --name=postgres postgres
|
|
$ docker run -d -p 6379:6379 --name=redis redis
|
|
$ docker run --rm -e DATABASE_URL="postgresql://postgres:mypass@172.17.42.1/asciinema" asciinema/asciinema.org bundle exec rake db:setup
|
|
# starting sidekiq using the provided start_sidekiq.rb file will also start sendmail service if you don't want to use SMTP
|
|
# otherwise start sidekiq by starting: bundle exec sidekiq
|
|
$ docker run -d -e DATABASE_URL="postgresql://postgres:mypass@172.17.42.1/asciinema" asciinema/asciinema.org ruby start_sidekiq.rb
|
|
$ docker run -d -e DATABASE_URL="postgresql://postgres:mypass@172.17.42.1/asciinema" -p 3000:3000 asciinema/asciinema.org
|
|
```
|
|
|
|
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.
|
|
|
|
### 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
|
|
|
|
* libtsm
|
|
See [here](http://cgit.freedesktop.org/~dvdhrm/libtsm/tree/README) 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:
|
|
|
|
```bash
|
|
$ 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:
|
|
|
|
```bash
|
|
$ ./script/setup
|
|
```
|
|
|
|
#### 5. Run Rails server
|
|
|
|
```bash
|
|
$ bundle exec rails server
|
|
```
|
|
|
|
#### 6. Run the background job processor
|
|
|
|
The background job processor is needed for asciicast pre-processing and
|
|
thumbnail generation.
|
|
|
|
```bash
|
|
$ bundle exec sidekiq
|
|
```
|
|
|
|
## Contributing
|
|
|
|
If you want to contribute to this project check out
|
|
[Contributing](http://asciinema.org/contributing) page.
|
|
|
|
## Authors
|
|
|
|
Developed with passion by [Marcin Kulik](http://ku1ik.com) and great open
|
|
source [contributors](https://github.com/asciinema/asciinema.org/contributors)
|
|
|
|
## Copyright
|
|
|
|
Copyright © 2011-2015 Marcin Kulik. See LICENSE.txt for details.
|