the fast, reliable localhost tunneling solution

Using CNAMEs with PageKite

By Bjarni R. Einarsson 2018-07-26, 01:29

Not everybody wants a website with a name like, many already own their own domain names and would rather use those.

In fact, this is recommended - it provides a layer of abstraction and independence between your identity on-line and the PageKite Service. If you use a CNAME, you will more easily be able to move your website to some other solution or provider at a later date, if you so choose.

Obviously we hope you won't ever feel the need to do so, but having the freedom to choose is important.

How it's done

Let's assume you own and have a PageKite Service account named, and you want to be served over PageKite.

The recommended CNAME-based configuration would involve the following steps:

  1. Create using this form
  2. Create a CNAME record for linking it to
  3. Add to your PageKite account using this form
  4. Follow the instructions below to add the required back-ends to your PageKite configuration file.


Step 1. is technically not required, you could also create a CNAME directly on However, by using a separate name, you preserve the ability to later use the two names for different websites on different computers.

How exactly to go about step 2. varies depending on where you bought your domain name. We hope to provide more details on the following, if you can help please feel free to edit these pages or upload screenshots:

Steps 3. and 4 are required to integrate the new name into your PageKite configuration.

Limitations of CNAMEs

Note that if you own and receive e-mail on that domain, then you can not create a CNAME for the top level name.

This is due to technical details of how DNS and e-mail interact. Generally you can create a CNAME for any other name ( or or to name a few), just not for the top level name itself.


Once the DNS records have been created and your PageKite account brought up to date, you need to reconfigure to know about your domain.

This usually requires adding two lines to your configuration file, which would look like this:

(Older versions of used backend= instead.)

Both lines are needed, as the first will guarantee that the DNS records for are kept up to date as your front-ends change, and the second takes care of actually registering and routing traffic for

(Note that if you want to expose HTTPS or SSH servers you will need to add lines for those as well.)


  1. adolfo said on 2012-04-13, 18:40
  2. Mozart said on 2012-07-20, 15:36
    Where exactly do I need to put these lines?

  3. Bjarni Rúnar Einarsson said on 2012-07-20, 15:41
    Please see for details on configuring
  4. Mozart said on 2012-07-20, 20:20
    Thanks for your swift reply.
    I successfully ran --add 80 --add 443

    But --add 80 --add 443
    gives errors:
    .. !!! REJECTED: (Invalid account or shared secret)
    and does not creat a kite is listed as CNAME under in my account overview.

    Could you help me out again?
  5. Bjarni Rúnar Einarsson said on 2012-07-21, 22:57
    Actually, the main point of the link I sent was it describes where you can find your configuration file (.pagekite.rc or pagekite.cfg depending on your operating system). I think it's still necessary to edit it by hand for CNAME records, although I hope to correct that in a future release of the software. Sorry I wasn't more clear!
  6. Chad said on 2012-08-14, 17:49
    hey guys... after I attempt to edit this file on my Windows 2008 R2 server, I try to relaunch and it doesn't start up.

    Where in the config file do I add these lines?

    Are they tab delimited, or can I just copy/paste the code above and modify with my own info?

  7. Bjarni Rúnar Einarsson said on 2012-08-14, 19:45
    Spaces or tabs, either or both should be fine. Copy-paste probably works, but take care not to have duplicate definitions. Note that the --backend syntax has been replaced by --service_on in PageKite 0.5 - the old syntax still works (they are completely equivalent), but this can be a source of confusion as you may not realize that you have duplicate lines.
  8. Marty Ballard said on 2012-11-29, 03:11
    For step 2 above, if you went with, you'll need to add a new DNS with the following format:
    Hostname: www
    Record Type: CNAME
    Target Host:

  9. Nils said on 2013-01-30, 15:22
    i own the domain and want to point it to domain. Following point 2 in the instructions above i entered the line "www IN CNAME" into the zonefile for Unfortuntly a "host" now answers is an alias for has address

    what did i do wrong?
  10. name-cheap - CNAME (Alias) worked ! said on 2013-03-01, 18:22
    Hi all,

    great thing you put together - just what I was looking for - since 5 (!) days ... so YOU need better marketing (joke) - or I need better search-engine-handling ...

    However - I just bought a domain at NAME-CHEAP - and here is my aff-link - in case you wanna help me become rich:


    1: lets assume you bought " " @ name-cheap.

    2: log in and click on that domain name

    3. scroll down a bit, left side is " Host-Managment", click on "All Hosts Records"

    4. first line: look at Hostname (@)

    4a. enter (IP-Address/URL):
    4b. choose (Record Type): URL-Redirect
    4c. choose (TTL): 1800

    (This takes care for the redirection of ( to (

    5. second line: look at Hostname (www)

    5a. enter (IP-Address/URL):
    5b. choose (Record Type): CNAME (Alias)
    5c. choose (TTL): 1800

    Thats it! --- you are all set and BOTH domains ( AND are pointing to

    Hope that helps,

    thanks for reading,

    please do NOT forget to enter your CNAME url into the settings script ...
  11. Steve said on 2015-04-09, 04:52
    OMG, what I get for a week is only ".tk not a service domain"
    when I try to add my domain to pagekite.
    hosting website is
  12. Femi said on 2016-01-22, 13:38
    I cant seem to redirect the domain in 1and1 control panel. It keeps saying this url is invalid.
  13. Shaikh Amaan FM said on 2016-11-25, 16:44
    What is the pagekite's nameserver?
  14. DanIel hongo said on 2017-12-15, 10:35
    i want mine to cname to how do i do it?
  15. David said on 2017-12-18, 09:49
    Hi. Is this service only available to pc users? I need help using it on android
  16. joy said on 2018-06-25, 22:33
    This was really helpful

Leave a comment

( (Please leave these blank: )

We use Gravatar for commenter's photos. Get your own, it's free!