# Install

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

1. [Install Node & Other Dependencies](https://learn.bevry.me/node/install)
2. Update [npm](https://docs.npmjs.com) and install DocPad

   ```bash
    npm install -g npm
    npm install -g docpad@latest
   ```

   **Note:** If you encounter permission errors with the above, do not use `sudo`, in our experience using `sudo` with node only creates further issues (regardless of DocPad). Follow our Step 1 instructions for a way to install Node with permissions that never require the use of `sudo`.

   You can verify DocPad has installed correctly by using `docpad -V` to output DocPad's version number.
3. **When upgrading:** in addition to the above, run `docpad update` inside your project directory to ensure that your local installation of DocPad and its plugins are updated to their latest compatible versions.

*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*](/start/troubleshoot.md) *as there's probably already a working solution. :-)*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docpad.bevry.me/start/install.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
