Docs » Deployment & Domains

Watch a screencastAttach a custom domain to your Webhook site

Webhook is a fully hosted system, so deploying your site is pretty trivial. When you're happy with the changes on your local server navigate to your site directory and type the following into your terminal:

# Run the following in your Webhook site's directory
wh deploy

This zips up your local files (regardless of their git state if you are using versioning) and deploys the site up to our servers. We then unzip them and run a fresh rebuild. This process is usually pretty speedy, but if your site is made of more than a few hundred pages expect a slight delay.

Custom domains

Once you've upgraded to a paid version of webhook you can attach a custom domain to your site. To do so, go into your CMS and click on domains in the left menu.

1. Attach your domain to Webhook

Type in a domain you already own and wish to use. If you don't yet have a domain, we recommend buying one at Name Cheap.

2. Point your DNS to us

Next, you'll need to point your DNS to dns.webhook.com. Below, we show doing this on GoDaddy, but every domain registar will have similar forms. It's usually under "Zone file" or "Host Domains".

You will have two edit two or three values depending upon whether you set up your site with a subdomain (www.mysite.com, blog.mysiste.com, ...etc) or are using a naked domain (mysite.com).

Create or edit a TXT record with the values Webhook provides. We use this to verify you own the domain.

Create or edit a CNAME for www (or any other subdomain you wish to use) that points to dns.webhook.com.

If you want example.com to redirect to www.example.com point your host or @ record to 174.129.25.170. If you are using Webhook on a subdomain like blog.webhook.com, then you don't need to set the @ record.

Once complete, you'll need to wait for your DNS to update, which can take up to an hour but is usually pretty speedy.

URL Redirects

Webhook also allows for permanent 301 redirects if you need to point old URLs to your new Webhook structure. This can be found in the "URL Redirects" section of your CMS.

Note that redirects only work on hosted sites that have attached a custom domain. The redirect format follows standard NGNIX syntax.