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
PencilBlue Command-line interface
- Install the pencilblue-cli module:
sudo npm install -g pencilblue-cli
pbctrl install [directory]where [directory] is the directory you want PencilBlue to be installed to.
- Follow the install instructions
- After the installation is done,
cdinto the folder where you installed PencilBlue
- Clone the PencilBlue repository
cdinto the cloned repository's folder
npm installto 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.js. The file can reside in two places: within the root folder of your installation as
/etc/pencilblue/config.js. 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.
Target Date: Mid-December 2015 New Features:
- Multisite support
- #501 - Route localization
The full list can be found here.
Features in progress: Check out our Waffle board.
Help & Support
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
- Bug fixes should be merged to master & features should be merged to the next release branch