Using Ghost as an NPM module

You can now use Ghost as a NPM module!

The API for using Ghost as an NPM module is changing in 0.5.2.

Calling ghost() will no longer start an express server. If you have setup Ghost this way with Ghost <0.5.2 you will need to change the code that calls the module. The new API signature will be:

var ghost = require('ghost');
ghost().then(function (ghostServer) {
 ghostServer.start();
});

This documentation will be updated with more details closer to the release.

1. Include Ghost as a dependency in your package.json file

"dependencies": {
 "ghost": "0.5.2"
}

2. Run npm install to install Ghost.

3. Include the Ghost module where desired and then invoke it to get a promise for a ghostServer object.

var ghost = require('ghost');
ghost().then(function (ghostServer) {
 ghostServer.start();
});

At this point Ghost should be running!

The GhostServer object returned by the ghost() promise has the following API:

The base express instance

Reference to the Ghost config module

Starts a server listening for requests on the host & port or socket configured in config.js.

• Takes: an optional express instance.
• Returns: a promise which resolves with the ghostServer instance once the server has successfully started

Stops the server

• Returns: a promise which resolves with the ghostServer instance once the server has successfully stopped

• Returns: a promise which resolves with the ghostServer instance once the server has successfully restarted

By default Ghost will use the content/ directory that exists inside the module. To modify where Ghost's content/ directory should exist you can pass in a JSON object into the ghost() function. For sake of easy maintenance you can also pass in a JSON file:

ghost({
config: path.join(__dirname, 'config.js')
});

An example config.js is based off the config.example.js.

The configuration property that changes the content/ location is:

paths: {
 contentPath: path.join(__dirname, '/content/'),
}

Modify that to change where the content/ directory should exist.

NOTE: If you change the location of the content/ directory Ghost expects to find the same directory structure that exists in the module. To get started copy the default content directory structure as the basis for your custom content/ location.