Getting started

This is a very short guide to using Travis CI with your GitHub hosted code repository. If you’re new to continuous integration or would like some more information on what Travis CI does, start with Core Concepts for Beginners instead.

Prerequisites #

To start using Travis CI, make sure you have:

To get started with Travis CI #

  1. Go to Travis-ci.com and Sign up with GitHub.

  2. Accept the Authorization of Travis CI. You’ll be redirected to GitHub.

  3. Click the green Activate button, and select the repositories you want to use with Travis CI.

  4. Add a .travis.yml file to your repository to tell Travis CI what to do.

    The following example specifies a Ruby project that should be built with Ruby 2.2 and the latest versions of JRuby.

    language: ruby
    rvm:
     - 2.2
     - jruby
    

    The defaults for Ruby projects are bundle install to install dependencies, and rake to build the project.

  5. Add the .travis.yml file to git, commit and push, to trigger a Travis CI build:

    Travis only runs builds on the commits you push after you’ve added a .travis.yml file.

  6. Check the build status page to see if your build passes or fails, according to the return status of the build command by visiting Travis CI .com build status and selecting your repository.

Selecting a different programming language #

Use one of these common languages:

language: ruby
language: java
language: node_js
language: python
language: php

Or pick one from the full list.

Selecting infrastructure (optional) #

The best way to determine what infrastructure your build runs on is to set the language. If you do this your build runs on the default infrastructure (with a few exceptions), which is Container Based Ubuntu 14.04. You can explicitly select the default infrastructure by adding sudo: false to your .travis.yml.

  • If you need a more customizable environment running in a virtual machine, use the Sudo Enabled infrastructure:

    sudo: enabled
    
  • If you have tests that need to run on macOS, or your project uses Swift or Objective-C, use our OS X environment:

    os: osx
    

    You do not necessarily need to use OS X if you develop on a Mac. OS X is required only if you need Swift, Objective-C or other macOS-specific software.

More than running tests #

Travis CI isn’t just for running tests, there are many others things you can do with your code:

Further Reading #

Read more about