This article is about Codeship Basic.

Getting Started With Codeship Basic

You will need roughly 5 minutes to read this article.

About Codeship Basic

Codeship Basic makes it easy and simple to get a working CI/CD process running through an easy-to-configure web UI and turnkey deployments.

This article will walk you through setting up a Codeship Basic project. For a video introduction to Codeship Basic, you can view our overview video.

Creating Your Account

To create your account and project, you will just need to connect a repository to Codeship. We have a guide here for how to do that.

Since this article is about setting up a Codeship Basic project, you’ll want to be sure to select the Basic infrastructure when adding your project.

Select Basic Infrastructure

Configuring Your Setup Commands

After selecting the Basic infrastructure for your project, Codeship will next ask you to configure your setup and test commands.

First, you will configure your setup commands. Setup commands are the commands you need to be able to run your tests and deployments. Typically these are things like fetching dependencies and seeding database.

Setup Commands on Codeship Basic

Note that Codeship provides a list of popular setup commands for many common languages in the dropdown, but you can enter in your own commands as needed.

Configuring Your Test Commands

Next, you will enter in your test commands. These are all tests you want to have run in your CI/CD pipeline, and all deployments you configure will be contingent on these tests passing.

Setup Commands on Codeship Basic

Configuring Your Deployments

Now that you’ve defined your setup and test commands, you’ll want to define your deployment pipelines. Deployment pipelines run only when a build’s setup and tests commands have completed successful and only when the branch defined for the deployment is matched. We call them deployment pipelines rather than deployments because you can have different deployment destinations - perhaps staging and master environments - triggered by different branches.

Defining the branches that will trigger your deployment pipelines is the first step. You can either match a specific branch - i.e. master - or you can choose to match any branch that starts with a specific string.

Add New Deployment Pipeline on Codeship Basic

Turnkey Deployments

After specifying which branch triggers your new deployment pipeline, you can choose to use one of Codeship’s turnkey deployment integrations or to use your own custom script deployment.

If you want to use one of Codeship’s turnkey deployment integrations, just click on your host provider and provide the necessary account credentials as requested.

Add New Deployment Pipeline on Codeship Basic

Custom Script Deployments

If you don’t want to use one of the turnkey deployment integrations, you can instead use your own custom script deployment. From the list of deployment targets, just select the last option - Custom Script.

Custom Script Deployment on Codeship Basic

From there you will be presented with a command window, just like when you entered your setup and test commands, in which you can define what deployment scripts or commands you would like to run.

Custom Script Deployment on Codeship Basic

Multiple Deployment Steps

It’s worth noting that for each deployment pipeline, you can add multiple deployments or multiple deployment steps. For instance, you can have one deployment on a master pipeline that runs your deployment scripts followed by another pipeline that runs notification scripts.

To add multiple steps or deployments to a pipeline, just click on an additional deployment target and specify as needed. You can then use the simple drag-and-drop interface to arrange the deployment commands in the order you need them to run in.

Custom Script Deployment on Codeship Basic

Accessing Codeship using the API

If you’re looking to automate more of your processes, you can access your projects and builds via the Codeship API. See the Codeship API Documentation for more details and examples.

Scripts Library

We maintain a scripts library with scripts for common packages, deployments and other useful workflow improvements on Codeship Basic.

If you’re looking for a specific tool or version, the scripts library is a great first place to check.

Common Questions


Codeship Basic has an automatic, built-in dependency cache, meaning we cache the packages directory for the most common dependency management systems, like NPM and Rubygems. You can clear your dependency cache at any time via the sidebar.

Reset Dependency Cache

Skipping Builds

By using the string --skip-ci in your commit message, you can instruct Codeship not to run a build for a particular commit. You can learn more about this via our article on skipping builds


Codeship offers the option to upgrade your Basic account with additional parallel test pipelines, allowing you to run multiple test commands simultaneously as a way to speed up your builds.

Parallel test pipelines on Codeship Basic

You can sign up for a free ParallelCI trial from the sidebar or get in touch with us to discuss configuration options.


Codeship Basic builds run on fresh VMs provisioned on Ubuntu 18.04 (Bionic). You can learn more about our infrastructure setup here

System Timeouts

If a command runs for longer than 10 minutes without printing any log output, the command and build will be automatically failed. Additionally, if a build runs for longer than 3 hours, it will be automatically failed.

Need more help?

Contact our support team or post on Stack Overflow using the tag #codeship. Did you check the status page and changelog?

There are also several code examples and sample projects available for you to get started with.

Article not helpful?

Does this article need improvement? If so, please send feedback or submit a pull request!