Skip to content
The public Travis API
Ruby Other
Find file
Latest commit 2c60a85 @rkh rkh Merge pull request #226 from travis-ci/rkh-v3-metrics
v3: add metrics

The public Travis API

This is the app running on


  1. PostgreSQL 9.3 or higher
  2. Redis
  3. RabbitMQ
  4. Nginx *NB: If working on Ubuntu please install Nginx manually from source. This guide is helpful but make sure you install the latest stable version, include the user name on your ubuntu machine when compiling (add --user=[yourusername] as an option when running ./configure), and don't follow any subsequent server configuration steps. Travis-api will start and configure its own nginx server when run locally.



$ bundle install

Database setup

  1. rake db:create db:migrate
  2. for testing 'RAILS_ENV=test bundle exec rake db:create db:migrate --trace'
  3. Clone travis-logs and copy the logs database (assume the PostgreSQL user is postgres):
cd ..
git clone
cd travis-logs
rvm jruby do bundle exec rake db:migrate # `travis-logs` requires JRuby
psql -c "DROP TABLE IF EXISTS logs CASCADE" -U postgres travis_development
pg_dump -t logs travis_logs_development | psql -U postgres travis_development

Repeat the database steps for RAILS_ENV=test.

RAILS_ENV=test rake db:create db:structure:load
pushd ../travis-logs
RAILS_ENV=test rvm jruby do bundle exec rake db:migrate
psql -c "DROP TABLE IF EXISTS logs CASCADE" -U postgres travis_test
pg_dump -t logs travis_logs_test | psql -U postgres travis_test

Run tests

$ rake spec

Run the server

$ bundle exec script/server


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

API documentation

We use source code comments to add documentation. If the server is running, you can browse an HTML documenation at /docs.

Something went wrong with that request. Please try again.