If you are upgrading from one major version to another (e.g., DocPad v5 to DocPad v6), be sure to checkout our Upgrade Guide for information relating to backwards compatibility breaks.

  1. Install Node.js & Other Dependencies

    DocPad works best with the latest stable Node.js version installed (currently v0.12 or io.js). If you're still running Node v0.10 or below, we'd recommend upgrading using the instructions above to get the best experience. You can find out what Node.js version you are running with the command: node --version

  2. Update NPM and Install DocPad

     # npm install -g npm; npm install -g docpad@6.78

    Note: The above should not require sudo (the # means sudo). If it does, we recommend reinstalling Node.js so that it doesn't. Otherwise you're likely to run into permission problems in the future. Follow the Step 1 instructions to reinstall Node.js without requiring sudo.

  3. When upgrading: in addition to the above, run docpad update inside your project directory to ensure that your local installations of DocPad and its plugins are updated to their latest compatible versions

  4. When you run DocPad for the first time using docpad run, you'll be asked if you agree with the Terms of Service. The TOS is necessary due to our extreme transparency and respect for our users. We want to make sure that our respect for your information is guaranteed, and that it will never be abused. Without a TOS, expectations can become misaligned and problems could occur. We would never want that. We want our users to know the exact measures we take in order to best serve you (collecting statistics, running newsletters, expanding the business, etc.), just so you know how highly we regard you over ourselves. If you run into trouble with the ToS, check this FAQ entry.

If you get any errors, try running DocPad anyway (most installation errors are non fatal and just for debugging purposes). If you do get a fatal error then refer to our Troubleshooting Guide as there's probably already a working solution. :-)

IRC Chat