PencilBlue

A full featured Node.js CMS and blogging platform (plugins, server cluster management, data-driven pages)

First and foremost: If at any point you have questions, comments or concerns you can find us hanging out on twitter @getpencilblue and on our subreddit. We're always happy to help and pull requests (plugin or core) are always welcome.

To learn how to build websites with PencilBlue, read our tutorials.

The first open source content management system to meet all the needs of a modern website:

Full blogging capabilities, out of the box
Relational data creation and management, through the admin interface
An expansive plugin framework that allows for modification of even core platform functionality
Designed for the cloud, with built in support for server clustering and high availability websites
Built in support for some of the latest and most popular web technologies, including MongoDB, Redis, Bootstrap, AngularJS, and jQueryUI
100% mobile ready through responsive web design
Touch friendly, drag and drop website management experience that's easy for non-technical users to learn

Read the Quickstart Guide

Installation

![LAUNCH ON OpenShift](http://launch-shifter.rhcloud.com/launch/LAUNCH ON.svg)

The instructions below assume that Node.js and MongoDB are installed on your machine. If they are not then please visit http://nodejs.org and http://www.mongodb.org to install them.

PencilBlue Command-line interface

Install the pencilblue-cli module: sudo npm install -g pencilblue-cli
Run pencilblue install [directory] where [directory] is the directory you want PencilBlue to be installed to.
Follow the install instructions
After the installation is done, cd into the folder where you installed PencilBlue
Run pencilblue start

Manual installation

Clone the PencilBlue repository
cd into the cloned repository's folder
Run npm install to retrieve PencilBlue's dependencies. Depending on your system access privileges, you may have to run sudo npm install
(Optional) Install Redis for caching
(Optional) Create a custom configuration file using the provided sample.config.json. The file can reside in two places: within the root folder of your installation as config.json or at /etc/pencilblue/config.json. The installation root takes precedence. If running all services locally, no configuration file is needed, but a configuration file is necessary for overriding specific settings.
Start PencilBlue. You can simply run node pencilblue, but we recommend using nodemon for development and forever for production. Nodemon will restart PencilBlue on file changes and forever will ensure that PencilBlue is always running.

# development
nodemon pencilblue

OR

# production
sudo forever start pencilblue.js

Navigate to the site root you specified in a configuration file or http://localhost:8080 by default.

Help & Support

Aways start with our wiki or code level documentation. The source never lies. Additionally, always feel free to leave questions on our issues page or reach out to us on Twitter at @GetPencilBlue.

Submitting Issues: When submitting an issue or request for help please provide the following information.

Step by step instructions to reproduce
Configuration overrides (minus any credentials)
Environment details: Linux, windows, hosting provider, local, etc.
Log output. Set your logging.level configuration property to "silly".

Submitting a Pull Request:

Provide a detailed description of what changed.
Reference any related issues by number so they can be tracked and linked back to the PR.
Document any new functions so they show up in our auto-generated documentation
Create tests for any new functionality
RUN npm test
Bug fixes should be merged to master & features should be merged to the next release branch

devgroup722/pencilblue