Open Source Continuous Integration & Deployment Server
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.idea Add IntelliJ code style definition Jul 18, 2016
bin fix(db): move mongoose setup to a utility that can be reused Aug 10, 2018
client fix(client/layout): remove build specific footer, fix layout, show fo… Aug 10, 2018
dist fix(client/layout): remove build specific footer, fix layout, show fo… Aug 10, 2018
docs docs: remove unused sections from git-gog Jul 30, 2018
lib fix(client/layout): remove build specific footer, fix layout, show fo… Aug 10, 2018
public Remove unused ui-sortable Jan 29, 2016
test Revert change to fixtures from 8732b1b Aug 2, 2016
vendor Update fontawesome less Jan 25, 2016
.bowerrc directory directive is redundant Jul 18, 2016
.buildpacks Added Gemfile and Gemfile.lock to fix Heroku build Jun 23, 2015
.codeclimate.yml CC eslint channel 2 Jul 31, 2016
.editorconfig Update .editorconfig with settings from strider/client Jul 22, 2016
.eslintrc Use template strings Jul 22, 2016
.gitignore fix: minor tweaks and adding new plugins by default May 4, 2018
.npmignore Bring back the client dir for now Sep 14, 2016
.restart checkin .restart -- it must exist for watcher Oct 10, 2014
.travis.yml Fix unit testing Jul 20, 2016 chore(release): 1.11.0 Aug 10, 2018 chore: Create (#1032) Jun 21, 2017 Update contributing guide May 2, 2015
Gemfile Added Gemfile and Gemfile.lock to fix Heroku build Jun 23, 2015
Gemfile.lock Added Gemfile and Gemfile.lock to fix Heroku build Jun 23, 2015 Add .md to license Nov 25, 2014
Procfile Fix for heroku Nov 15, 2014 feat: Add jobs quantity customization (#1057) Jul 31, 2018
apidoc.json Add apidoc and start documenting API Jul 11, 2015
app.json Add Heroku button Sep 23, 2014
bower.json chore(release): 1.11.0 Aug 10, 2018
boxfile.yml Add boxfile for nanobox (wip) Dec 13, 2016 Fix script. (#943) Jun 10, 2016
docpress.json Start on docs Aug 2, 2016
main.js fix: context server name was undefined Feb 20, 2017
package.json fix: update simple-runner dep Aug 14, 2018
requirements.txt Clean up files leftover from Heroku buildpacks Jan 23, 2014
shim.js Remove unused ui-sortable Jan 29, 2016
yarn.lock fix(db): update mongoose to v5 and use new db uri format Jul 31, 2018


NPM Code Climate Dependency Status Build Status
Gitter Backers on Open Collective Sponsors on Open Collective

Brilliant Continuous Deployment

Strider Screenshot more screenshots


Strider is an Open Source Continuous Deployment / Continuous Integration platform. It is written in Node.JS / JavaScript and uses MongoDB as a backing store. It is published under the BSD license.

Strider is extremely customizable through plugins. Plugins can

  • add hooks to perform arbitrary actions during build.
  • modify the database schema to add custom fields.
  • register their own HTTP routes.
  • subscribe to and emit socket events.
  • create or modify user interfaces within Strider.
  • so much more! just use your imagination!

General Requirements

Note: Installing on OS X might require XCode to be installed.

  • The package krb5-devel/libkrb5-dev might have to be installed to resolve Kerberos related build issues on some systems.

Running on Infrastructure

Make sure you have MongoDB installed on your system. You can get the latest version at

Next you will need Node.JS. You can get binary packages for most platforms at

Once you have Node.JS on your system, you can fetch & install all the dependencies for your Strider clone by executing the following command in the project root:

npm install

Note: Sometimes there are issues with permissions and installing global modules, in those cases run npm config set prefix ~/npm to set your global modules directory to '~/npm'. You will also have to add ~/npm/bin to your PATH environment variable.


Strider configuration comes from environment variables. Most of the default values should work fine for running on localhost, however for an Internet-accessible deployment the following variables will need to be exported:

  • SERVER_NAME - Required; Address at which server will be accessible on the Internet. E.g. (note: no trailing slash, and included protocol)
  • HOST - Host where strider listens, optional (defaults to
  • PORT - Port that strider runs on, optional (defaults to 3000).
  • CONCURRENT_JOBS - How many jobs to run concurrently (defaults to 1). Concurrency only works across different project and branch combinations. So if two jobs come in for the same project and branch, concurrency will always be 1.
  • STRIDER_CLONE_DEST - Where the repositories are cloned to (defaults to ~/.strider)
  • DB_URI - MongoDB DB URI (with port number if local, e.g. localhost:27017) if not localhost (you can safely use MongoLab free plan - works great)
  • HTTP_PROXY - Proxy support, optional (defaults to null)
  • If you want email notifications, configure an SMTP server (we recommend Mailgun for SMTP if you need a server - free account gives 200 emails / day):
    • SMTP_HOST - SMTP server hostname e.g.
    • SMTP_PORT - SMTP server port e.g. 587 (default)
    • SMTP_SECURE - SMTP server TLS or SSL ("true" or "false")
    • SMTP_USER - SMTP auth username e.g. "myuser"
    • SMTP_PASS - SMTP auth password e.g. "supersecret"
    • SMTP_FROM - Default FROM address e.g. "Strider" (default)

Additional Configurations

  • BODY_PARSER_LIMIT - Increase the maximum payload size that our body parser will attempt to parse. Useful for github web hooks.
  • DEBUG - Set this to strider* to enable all debug output. This is very helpful when troubleshooting issues or finding the cause of bugs in Strider. For more information see
  • JOBS_QUANTITY_ON_PAGE_ENABLED - Whether users can set quantity in Account Management
  • JOBS_QUANTITY_ON_PAGE_DEFAULT - Number of jobs to display when not enabled
  • JOBS_QUANTITY_ON_PAGE_MIN - Minimal value
  • JOBS_QUANTITY_ON_PAGE_MAX - Maximum value

You might need to follow these instructions if you use any of these, please do so before filing issues.

Adding Initial Admin User

Strider isn't much use without an account to login with. Once you create an administrative user, you can invite as many other people as you like to your instance. There is a simple CLI subcommand to help you create the initial user:

node bin/strider addUser

Example run:

$ node bin/strider addUser
Enter email []:
Is admin? (y/n) [n]: y
Enter password []: *******

Password: ****
isAdmin:  true
OK? (y/n) [y]:
22 Oct 21:21:01 - info: Connecting to MongoDB URL: mongodb://localhost:27017/strider-foss
22 Oct 21:21:01 - info: User added successfully! Enjoy.

See the strider-cli for more details.

If you want to connect to your ldap server to authorization
you can also add the ldap.json config file to project root
the config like so:

    "url": ldap://host:port,
    "baseDN": dnString,
    "username": username,
    "password": password,
    // If you want to set a admin group
    "adminDN": dnString

Starting Strider

Once Strider has been installed and configured, it can be started with:

NODE_ENV=production npm start

Strider on Heroku


To get up and running quickly on Heroku, you can simply use the button above. If you run into any issues, see the wiki entry.

Strider in Docker

Many users like to run Strider within a Docker container. Although this works well, supporting it is outside the scope of the Strider project.

We recommend using docker-strider as a base image when designing your Docker-based Strider installation. Please post related issues in the issues section for that repository.


  • Strider Tutorial Series - Extensive guides about Strider covering platform setup, 3rd party integrations (GitHub, GitLab, etc), continuous deployments (Heroku, SSH), notifications (email, Slack, HipChat), how to create your own Strider plugin and many more.
  • Strider on DigitalOcean - Covers setting up an Ubuntu machine with Strider using upstart.
  • Strider plugin template - Simple setup for getting started with your own plugin.
  • Panamax Strider template - Strider template for use with Panamax.

Advanced Topics

Advanced topics are located in the Wiki, here's a small subset of what's covered:

API Documentation

An effort has been started to document the existing REST API, and to have versioned documentation going forward. We use apiDoc for the documentation.

To build the documentation run npm run docs and the documentation will be accessable from apidocs/index.html.

View Strider API Docs


Support us with a monthly donation and help us continue our activities. [Become a backer]


Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]

Support & Help

We are responsive to Github Issues - please don't hesitate submitting your issues here!

For live help check out Strider's Gitter.