Congratulations and thank you for purchasing your hosting account from The Kiwi Web Hosting Company™. Here is how to get started with your web hosting account. Please read these steps carefully before contacting us with any questions. Throughout this tutorial, please replace all references to yourdomain.co.nz with the full domain name for your account.
Configuring Your Domain Name
If you elected for us to register your domain, we will point it to the correct server for you. If you did not register your domain with us or are transferring your domain to us, you will need to set the primary and secondary server hostnames as described in your Welcome email.
Most domain registrars provide you with a place to login and manage your domain's name servers. If you don't know how to do that or do not have a place to login and manage your domain, please contact the place where you registered your domain from and tell them to change your domains name servers to ours. If your domain name has a .nz extension, then you can also transfer the domain over to us, and then we can make the required modifications. If you would to do this, then all we require is the UDAI for the domain name - this should have been supplied when you first registered your domain name, and can also be requested from your existing registrar at any time.
NOTE: After changing name servers or registering a new domain name, it will take at LEAST 12 hours before you will be able to see your domain by going to http://www.yourdomain.co.nz/. This process normally takes between 12-72 hours. This delay, referred to as a DNS propagation delay, occurs with all hosts and is outside of our control. During this period, you may also experience intermittent connection to your domain. That is, it may become available, then disappear again a few hours later. This is also an artifact of the DNS propagation and will typically resolve itself within a few days after assigning the new name servers.
Until your domain fully resolves (1-3 days from the time you changed it) you will NOT be able to do the following:
- View your domain at http://www.yourdomain.co.nz/
- Upload files using FTP to ftp://ftp.yourdomain.co.nz
If You Are Transferring Your Web Hosting From An ISP...
If your existing hosting account is with an internet service provider (e.g. Xtra, TelstaClear, Ihug, Paradise), then it is critical that you contact them to let them know you are changing to a different web hosting provider. This needs to be done so that your ISP removes the "DNS zone record" for your domain. If your ISP still has a DNS zone record for your domain, then when you connect to the internet and try to collect email or modify your site, it will only look at the account with your ISP and not the rest of the internet. So although anybody connecting with any other ISP will be directed to your site on the new server, you (and anybody else connected to that ISP) will still only be able to "see" the site on the existing server. In our experience, with Xtra in particular, you need to not only cancel your account with them, but specifically request that they "remove the DNS zone record for your domain".
Creating Your Web Pages
If you don't already have a website, and are wanting to build your own, you will probably need some HTML authoring software. There many such programs available on the internet. A few recommendations for varying budgets are listed below:
- HomeSite - A powerful and relatively inexpensive package that's good for simple and advanced sites alike.
- Dreamweaver - The gold standard in web authoring software. It's somewhat pricey, but if you're serious about making a sophisticated website quickly and easily, Dreamweaver comes highly recommended.
For more alternatives, check out download.com. Of course if you're prepared to learn HTML, you can also just use a program like Notepad or Textpad to make your web pages.
The Unix Filesystem is Case-Sensitive
As our servers run the Linux operating system, the filesytem is case-sensitive. Therefore, it is important that any hyperlinks or references to images, scripts, directories etc in your HTML match those of the files they refer to.
Uploading Your Files
Once you've got your website ready, you can upload it onto our servers.
Despite the fact that you will not be able to access your domain via its name immediately after signing up, you can already start uploading your files onto the server. Once your domain name starts pointing to our servers, your site can already be set to go. Below are step by step instructions on how to FTP your files.
- Run your favourite FTP program (if you don't already have one, we recommend AceFTP)
- In the FTP program, set the FTP Host (the box labelled Host: in AceFTP) to ftp.yourdomain.co.nz. Alternatively, if your domain name has not yet resolved you can set it to ftp.<your server name>.net.nz instead. If you don't know your server's name, then you can email email@example.com to obtain the server specific to your account.
- Type in your username (the box labelled ID: in AceFTP) and password (the box labelled P/W: in AceFTP). Your username and password can be found in your Welcome email.
- Click the connect button or just push Enter. Some FTP programs may ask for a directory path or something similar, you should be able to just leave this blank or enter just "/".
- In most FTP programs, you should see the files/directories on your computer in one window and the files/directories associated with your account on ther server in another window. In AceFTP, the files on your computers are on the left and the files on the server are on the right.
- In the server window, you should open the "public_html" folder. This is where all files that you wish to be made visible on your website should be uploaded.
- Upload your files to the server by dragging them from your computer onto the server. Be sure that you have created a file called "index.html" or "index.htm". This file is your home page and will be viewed by default at your website (i.e. when you got ot http://www.yourdomain.co.nz/ in your web browser). Also be sure all letters are lowercase (for example Index.html is not the same as index.html). If the public_html directory does not contain a file named index.html or index.htm, a directory listing of your files will appear on your website by default.
- Until your domain name has fully resolved, you can access your webpages at http://yourdomain.kiwiwebhost.net.nz.
Setting Up Your Email Account(s)
Email directed at your domain name can be received in a number of different ways. How you wish to receive your email will depend on your own personal requirements and preferences. The instructions for the various configurations described below should cover virtually all possible scenarios. Please remember that you won't be able to receive mail directed at your domain name until the DNS has fully propagated.
A. Setting up an individual POP3 email account. An individual POP3 account will only receive mail specifically directed at that account's username, i.e. firstname.lastname@example.org. Each POP3 email account has its own unique username and password. To set up a POP3 email account, follow the instructions below:
- Log in to the site admin control panel at the temporary URL in your welcome email.
- Click the "Mail" icon.
- Select the "Add / Remove Accounts" link.
- This shows a list of your current email addresses. Initially one address should appear there - this is your "catch-all" email account. Note: the "catch-all" account is initially disabled and cannot be removed. It can be enabled or re-routed (see B. below).
- Type the username you would like for your email account. For example if you want the email address "email@example.com" you would create a user called "webmaster". Create a password and click "Create".
- You have just created a POP3 Email account. You can check it using webmail or a POP3 email client:
- To check your account with webmail, simply go to http://yourdomain.co.nz/webmail and enter the full email address as the username (e.g. firstname.lastname@example.org) and the associated password.
- To check your account with an email client, follow the instructions exactly as for setting up a "catch-all" account (listed below), except in step 4, set the username as the full email address that you set up in CPanel (e.g. email@example.com) and set the corresponding password appropriately. Note: the username and password for server authentication in step 7 should still be set as those for your main account. So, for clarity, to summarise the settings for a separate pop email account:
Incoming mail server: mail.yourdomain.co.nz
Account Username: firstname.lastname@example.org
Password: as set up in Cpanel
Outgoing mail server: mail.yourdomain.co.nz
Username: your main account username - i.e. that used to login to Cpanel/FTP
Password: that of your main account - i.e. that used to login to Cpanel/FTP
Note: the username in both webmail and your email client is case-sensitive and should be entered in all lowercase characters.
B. Forwarding all email for your domain to an existing account. You may wish to simply forward any mail directed to yourdomain.co.nz to an existing email account. If you choose to do this, you will not need to make any changes to the settings in your email client.
- Login to the site admin control panel at the temporary URL in your welcome email if your domain name has not yet fully propagated.
- Click the "Mail" icon.
- Select the "Default Address" link.
- Click on "Set Default Address"
- Select your domain name in the drop-down menu on the left, then in the box to the right, enter the email address you would like the mail forwarded to.
- Click on "Change". Once your domain name has fully resolved you will be able to test if you've done it correctly simply by sending some email to email@example.com
C. Forwarding email directed at different addresses to various existing accounts. You may wish to forward email directed at different addresses of yourdomain.co.nz to different people. e.g. firstname.lastname@example.org may go directly to email@example.com and sales.co.nz directly to firstname.lastname@example.org. This can be set up using the instructions below:
- Log in to the site admin control panel at http://yourdomain.co.nz/cpanel/ (or http://yourdomain.kiwiwebhost.net.nz/cpanel if your domain name has not yet fully propagated).
- Click the "Mail" icon.
- Select the "Forwarders" link. This page will list all forwarders set up for your account.
- Click on "Add Forwarder"
- Enter the name of the address in the left box (e.g. webmaster) and enter the full destination email address in the right box (e.g. email@example.com).
- Click the "Add Forwarder" button. After the forwarder has been created, you can follow the "Go Back" link to check that it has been created correctly. Any changes made are effective immediately, so you should be able to test if the forwarder is working by sending an email to the new address.
Note: 1. Individual POP3 accounts should not be created for addresses that are being forwarded. Doing so, will result in messages being both forwarded and stored on the server. 2. Multiple forwarders can be set up for the same email address to allow the same mail to be sent to multiple addresses.
D. Receiving mail from your "catch-all" or "wildcard" email. The "catch-all" account will catch all mail directed at your domain for which there isn't a specific POP3 account set up already (see A. above for setting up specific POP3 accounts). By default, the catch-all email account is disabled on all new accounts. To enable this feature, you'll need to follow the instructions in B. above, except in step 5, set the destination to your CPanel username. Following this change, to check this mail from a conventional email client, such as Outlook Express, follow the instructions below:
- Open your email client and add a new account. In Outlook Express new accounts are added by going to the Accounts option in the Tools menu, selecting the "Mail" tab and clicking Add --> Mail.
- Enter the display name and email address (the email address should be in the format firstname.lastname@example.org).
- Set both the incoming (POP3) and outgoing (SMTP) servers to mail.yourdomain.co.nz. If applicable, set the server type to POP3. If your DNS has not yet fully propagated you will not get mail delivered until it has.
- Set the username and password for your account as provided in your welcome email. In Outlook Express make sure the "Log on using Secure Password Authentication" option is unchecked.
- In Outlook Express, the create account wizard is now finished, however, there is one more option we need to address. Go to the Tools --> Accounts menu item and select the account you just created and click "Properties", then select the "Servers" tab.
- Check the "My server requires authentication" box and click "Settings".
- Select the "Log on using" option and enter your account's username and password as you did in step 4.
- Finally, in Outlook Express, just click Okay or Close on each window and you should be ready to go.
Your "catch-all" account can also be checked through Webmail. To do this, simply go to http://yourdomain.co.nz/webmail and enter your username and password. There are two alternative Webmail interfaces: Squirrelmail and Horde. Each essentially does the same thing and which you choose really depends on personal preference.
Note: Catch-all accounts can be abused and become big spam traps, and are disabled by default. Only enable this inbox if you wish to receive email in your catch-all account. You can deactivate it again at any time by setting the Default Address setting in Cpanel to :blackhole: or :fail:.
A Quick Word About Spam
One of the nastier artefacts of the internet revolution is spam. We've all seen it and we all hate it. As with most diseases, the best defence is prevention. If you have just registered your domain name, its associated addresses can be kept clean of spam by following a few simple precautions.
- Try to use your main email address (i.e. email@example.com) only for emailing known contacts. For signing up for services, catalogues or anything where your address will end up on a mailing list, use an alternate address (e.g. firstname.lastname@example.org). You can still set up forwarders so that this mail still ends up going to your main email address, or alternatively just use your catch-all account. Consequently, using alternate addresses need not be any extra hassle to collect. If one of these companies ever distributes, loses, or abuses the mailing list, you can simply put a block on that address, and your main email address is left intact.
If your email address has already been "poisoned", then you could consider blocking it and trying the above guidelines on a new address. If this isn't an option, you can activate SpamAssassin in your account's control panel, which does a pretty respectable job of filtering out the garbage.
If you have more questions, remember to check out our FAQ, which addresses many of the most common problems that our customers encounter.