Forge Home


Install and Manage Ghost Blog


9,525 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.3.0 (latest)
  • 0.2.1
  • 0.2.0 (deleted)
  • 0.1.3
  • 0.1.2
  • 0.1.1
  • 0.1.0
  • 0.0.5
  • 0.0.4
  • 0.0.3
  • 0.0.2
released Feb 26th 2015
This version is compatible with:
  • Puppet Enterprise 3.x
  • Puppet >= 3.3.0
  • ,
This module has been deprecated by its author since Oct 27th 2017.

The author has suggested puppet-ghost as its replacement.

Start using this module


andschwa/ghost — version 0.3.0 Feb 26th 2015


Table of Contents

  1. Overview
  2. Module Description
  3. Setup - The basics of getting started with andschwa-ghost
  4. Usage - Configuration options and additional functionality
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module


This module installs the Ghost Blogging Platform.

It is in beta development and tested on Ubuntu 12.04 and 14.04, loosely tested on CentOS.

Module Description

This module is intended for Ubuntu. It essentially follows the Linux docs and deployment instructions by using wget to grab the latest Ghost distribution, unzips it, runs npm install --production, configures the config file via a template (if desired), adds a proletaryo/supervisor program to run Ghost, includes puppetlabs/nodejs class, adds the ghost user and group, and finally starts ghost.


What andschwa-ghost affects

  • Packages
    • nodejs
    • npm
    • unzip
    • curl
    • supervisor
  • Services
    • supervisor
  • Files
    • /home/ghost/
    • /etc/supervisor/conf.d/ghost_<blog>.conf
  • User
    • ghost
  • Group
    • ghost

Beginning with andschwa-ghost

The simplest use of this module is:

class { ghost:
  blogs => {
    'my_blog' => {
      'url'  => '',


This module has one main class, ghost, with the following parameters:

$user          = 'ghost',                       # Ghost should run as its own user
$group         = 'ghost',                       # Ghost GID and group to create
$home          = '/home/ghost',                 # Ghost user's home directory, default base for blogs
$npm_registry  = '', # Ghost user's npm registry
$blogs         = {},                            # Hash of blog resources to create
$blog_defaults = {},                            # Hash of defaults to apply to blog resources

It delegates the user and group resources to ghost::setup, which executes npm config set registry to ensure the npm registry is correctly set (necessary at least on Ubuntu 12.04), and includes a module to setup nodejs.

The socket file created by Ghost must be readable by the web server (perhaps Nginx) for communication to take place, but its default permissions of 660 do not allow this. Because the Ghost server creates the socket file on each launch, it is impossible to control its permissions through Puppet. The best solution to this predicament (see issue #14) is to add your web server's user to Ghost's group (e.g. usermod -a -G ghost www-data), which will allow it to read the socket.

Ghost requires an up-to-date nodejs, which can be done automatically by setting that class's manage_repo parameter to true. If the nodejs class is not defined elsewhere, this module will simply include it.

The module has one main resource, ghost::blog, with the following parameters:

$blog   = $title,                    # Subdirectory and conf name for blog
$home   = "${ghost::home}/${title}", # Root of Ghost instance
$source = '',

# Use [supervisor]( to manage Ghost, with logging
$use_supervisor = true,
$autorestart    = true,
$stdout_logfile = "/var/log/ghost_${title}.log",
$stderr_logfile = "/var/log/ghost_${title}_err.log",

# Parameters below affect Ghost's config through the template
$manage_config = true, # Manage Ghost's config.js

# For a working blog, these must be specified and different per instance
$url    = '',                  # Required URL of blog
$socket = "${ghost::home}/${title}/production.socket", # Set to false to use host and port
$host   = '',
$port   = '2368',

# Mail settings (see
$transport    = '', # Mail transport
$fromaddress  = '', # Mail from address
$mail_options = {}, # Hash for mail options

These resources can be declared using Hiera by providing a hash to ghost::blogs specifying the blog resources and their parameters, like this:

    transport: SMTP
        pass: yourpassword
    socket: false
    host: localhost
    port: 2368

It is imperative that each separate instance has a different URL and port.

You can disable management of the config.js file by setting $manage_config to false.

You can disable the use and setup of supervisor by setting $use_supervisor to false.

Note that at least on my Ubuntu test systems, the supervisor module's execution of supervisorctl update fails; this can be fixed by manually running that command, letting it do its thing, and then re-provisioning.

You will likely want to proxy these using, say, nginx. Although the inclusion of nginx is outside the scope of this module, if you are using the jfryman/nginx module, you can declare the virtual hosts to proxy the blogs via Hiera like so:

      - unix:/home/ghost/vagrant/production.socket
  - Host $host
  - X-Real-IP $remote_addr
  - X-Forwarded-For $proxy_add_x_forwarded_for
  - X-Forwarded-Proto $scheme
nginx::server_tokens: 'off'
    use_default_location: false
    rewrite_www_to_non_www: true
    rewrite_to_https: true
    vhost: ghost
    location: /
    proxy: http://ghost
      proxy_ignore_headers: Set-Cookie
      proxy_hide_header: Set-Cookie


This module only officially supports Ubuntu, but ought to work with other operating systems as well.

If managing the blog's config.js via this module, you cannot currently setup Postgres.

If supervisor is not registering the blogs, restarting your system is the easiest solution (as always), but you should also try supervisorctrl reread && supervisorctl reload.

Upgrading from 0.1.x

To upgrade to 0.2.x from 0.1.x, you need to be aware of some major changes:

  • The license has changed from MIT to GNU Affero
  • The Ghost source parameter has been moved to ghost::blog
  • Blog's can have different settings for home (root of Ghost)
  • The proletaryo/supervisor module is now used to create a supervisor program in a cross-platform manner
  • The puppetlabs/nodejs module is now used to install nodejs and npm in a cross-platform manner
  • The 'development' config settings have been removed, in favor of setting up only production url, host, and port parameters
  • By default, Ghost is now setup to listen on a Unix socket at the location of the socket parameter (false disables this and falls back to host and port)
  • For most common uses, the socket file must have 'other' read/write permissions, and this is done with an exec because Ghost creates the socket file (Puppet is incapable of this)
  • Mail parameters transport, fromaddress, and a mail_options hash can be specified for each blog
  • The wget module dependency has been deprecated in favor of a simple call to curl


Fork on GitHub, make a Pull Request.