Docs » Installation

Webhook can be installed either as an application, or as a set of command line tools to run in your terminal. For new users unfamiliar with the command line, we recommend using our App.

Install Webhook as an App

Webhook is available as a downloadable application for both Mac and Windows. Using the app requires no other dependencies and will allow you to use Webhook without the Command Line tools. Simply install the application and run it to create your first site.

Download

Both apps might give warnings about installing programs from the Internet. This is normal.

Webhook for Mac OSX Webhook for Windows


Install Webhook as Command Line Tools

New to using your terminal?

The below commands, and the others in this documentation are typed in your computer's terminal.

  • For Mac users, that's an actual program called terminal that's located in /Applications/Utilities/Terminal.app.
  • For PC users, right-click your start menu, hit run, type in cmd then hit enter.

Installing Webhook on the command line is fairly simple. The only requirement is Node.

Windows Installation

1. Install Node

Node is an open source platform for building websites in Javascript. There are many ways to install Node, the easiest is by visiting their site and running the installer.

2. Install Webhook

Once Node is installed, open your terminal by right clicking the start menu and selecting "Command Prompt". Then run the following command.

# Type the below command in your command prompt.

npm install -g grunt-cli wh

This will install the Webhook command line tools. Once installed, you're ready to set up your first site.

To test that everything is working properly try spitting out Webhook's version in your terminal with the following command.

# Running this command should print out a version number.

wh -V

Command line tools for Mac

1. Install Homebrew

Homebrew is a package manager that lets you sanely install development programs on your computer. We highly recommend using it to install Node rather than using their installer.

To begin, open your Terminal by searching in spotlight for "Terminal" or clicking the app in /Applications/Utilities/Terminal.app. Once you have it open, paste the following line then hit enter:

ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"

2. Install Node

Now that we have Homebrew installed, we can install Node, an open source platform for building websites in Javascript. Just run the following command.

brew install node

3. Install Webhook

Once Node is installed we can finally install Webhook.

# Type the below command in your command propmpt.

npm install -g grunt-cli wh

This will install the Webhook command line tools. Once installed, you're ready to set up your first site.

To test that everything is working properly try spitting out Webhook's version in your terminal with the following command.

# Running this command should print out a version number.

wh -V

Troubleshooting

Every computer is a little different. If you're having trouble installing check the forums. Likely someone has already solved your issue.