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!
For more details check out the introductory chapter of the Strider Book
- nodejs, v0.8 or v0.10
- mongodb (local or remote)
- git >= 1.7.10
Make sure you have MongoDB installed on your system. You can get the latest version at mongodb.org.
Next you will need Node.JS. You can get binary packages for most platforms at nodejs.org.
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 ~/npmto set your global modules directory to '~/npm'.
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.https://strider.example.com(note: no trailing slash) -
HOST- Host where strider listens, optional (defaults to 0.0.0.0). -
PORT- Port that strider runs on, optional (defaults to 3000). -
DB_URI- MongoDB DB URI if not localhost (you can safely use MongoLab free plan - works great) -
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.example.comSMTP_PORT- SMTP server port e.g. 587 (default)SMTP_USER- SMTP auth username e.g. "myuser"SMTP_PASS- SMTP auth password e.g. "supersecret"SMTP_FROM- Default FROM address e.g. "Strider [email protected]" (default)
You might need to follow these instructions if you use any of these, please do so before filing issues.
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 []: [email protected]
Is admin? (y/n) [n]: y
Enter password []: *******
Email: [email protected]
Password: ****
isAdmin: true
OK? (y/n) [y]:
22 Oct 21:21:01 - info: Connecting to MongoDB URL: mongodb://localhost/strider-foss
22 Oct 21:21:01 - info: User added successfully! Enjoy.
See the strider-cli for more details.
Once Strider has been installed and configured, it can be started with:
NODE_ENV=production npm start
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.
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 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 are located in the Wiki, here's a small subset of what's covered:
We are very responsive to Github Issues - please think of them as a message board for the project!
You can find us on irc.freenode.net in #strider
If nobody is responding, don't leave immediately. Someone will eventually respond. If you don't want to wait please create a Github issue! Many Strider contributors don't use IRC at all, but will respond pretty quickly to new Github Issues.
Strider is maintained and supported by FrozenRidge, LLC. For commercial support, customization, integration & hosting enquiries please email [email protected].