Configuring the project on Codeship

The configuration information below is specific to Codeship Pro. For more information see

Once you have your project running locally you can configure the repository on Codeship and have the builds run on each push.

If you already worked with Codeship the process will be familiar (and if not, it should be very simple nonetheless).

  1. Click on the Select Project dropdown in the top bar and select the Create a new project button.
  2. Select the repository provider you want to host your repositories with.
  3. Select the repository you want to build on Codeship. You can filter the list via the search form. (If a repository belonging to an organization on GitHub isn’t listed, please take a look at 3rd party restrictions.)

    So far these are the standard steps to add a new project on Codeship.

  4. You can now choose between Codeship Basic (hosted) and Codeship Pro (Docker). Choose the latter. Select Codeship Pro
  5. You will be presented with a screen offering basic setup instructions, as well as a link to the documentation for Codeship Pro. Docker Project Help Screen

    As we already added all the required information to the repository, you can simply push a new commit and this will trigger a new build on Codeship.

  6. Once you trigger a (couple) new builds, you’ll see the standard Codeship build listing page. Build Listing
  7. Clicking on a single build takes you to the build details. Build Details

    The page is split in two panes. On the left hand side you will find basic build details, including the commit message, who triggered the build and which branch (or tag) triggered the build.

    You will also see the services defined in your codeship-services.yml file (if you click on the Services header as this section is hidden by default).

    The main portion of the left pane is dedicated to listing the steps you have defined. Clicking on a single step will open the step log in the right pane. Each step includes the following information:

    • the command you are running
    • the service the step is running on (on the right hand side)
    • the status indicated by an icon
  8. The remaining project configuration (e.g. team management or notifications) is identical to a standard Codeship project and accessible via the Project Settings dropdown at the top.

Need More Help?

Get in touch if you need more help, or post on Stack Overflow using the tag #Codeship.