Extract installation instructions into separate doc
parent
e12f100018
commit
43d19f3ad3
@ -0,0 +1,91 @@
|
||||
# asciinema web app install guide
|
||||
|
||||
## Quickstart Using Docker Compose
|
||||
|
||||
Required:
|
||||
|
||||
- [Docker](https://docs.docker.com/engine/getstarted/step_one/#step-1-get-docker)
|
||||
- [docker-compose 1.5+](https://docs.docker.com/compose/install/)
|
||||
|
||||
```bash
|
||||
$ 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](https://github.com/asciinema/libtsm/blob/asciinema/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
|
||||
```
|
||||
|
||||
## 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
|
Loading…
Reference in New Issue