Table of Contents

Domains

Typically, you’ll want to use your shared hosting account to serve websites and handle mail with your domain(s). A domain is typically understood as a hostname of two parts (e.g. mydomain.com), sometimes of three parts (e.g. mycompany.co.uk) - compared to subdomains which usually introduce an additional minor part (e.g. blog.mydomain.com).

Make sure you have enabled the web virtual server, otherwise you will not be able to serve websites from your domain. You can enable the web virtual server from Virtualmin by doing the following:

  1. Sign in to Virtualmin (see Account logins and important URLs).
  2. Select a virtual server from the drop-down in the left-hand navigation (your main virtual server should be already selected when you first login to Virtualmin).
  3. Click Edit Virtual Server in the left-hand navigation.
  4. Click Enabled features
  5. Select Web virtual server enabled? and Enable PowerDNS domain?
  6. Click Save Virtual Server

Adding a domain

First, you should own a domain - that is, have it registered with a domain registrar. Joyent does not provide a domain registrar service, so you’ll need to register a domain first with a 3rd party provider. Once you have a registered domain, do the following:

  1. Sign in to Virtualmin (see Account logins and important URLs).
  2. From the left-hand navigation, click Create Virtual Server.
  3. In the Domain name field, enter the desired name for your new domain (do not enter http://... or even www.) and a brief description in the Description field.
  4. Click Enabled features. From here you can decide whether you want to enable email, MySQL, WebDAV, Subversion etc. for your domain. Most of the features are disabled by default (including the web server!), so be sure to check over the options and enable what you need. It is a good practice to leave off things you don’t currently need; they can always be turned on later. Since you’re adding a domain, you’ll most likely want to enable Web virtual server enabled? to make your website accessible.
  5. Finally, click Create Server to create your domain.

Renaming a domain

  1. Sign in to Virtualmin (see Account logins and important URLs).
  2. Select a domain from the drop-down in the left-hand navigation (your main domain should be already selected when you first login to Virtualmin). The domain you select will be the one that you’ll be renaming.
  3. Click Server Configuration and click Change Domain Name.
  4. In the New domain name field, enter the new name for your domain.
  5. If you’d like to keep the name of the home directory for this domain, select Leave as /users/home/... for Change home directory, but usually you want the name change as well (this will have no effect on primary virtual servers).
  6. If you’d like to keep the names of your mail/SFTP users, select No for Rename mail / FTP users too?.
    • Remember, any users you create for a domain will have a username based on the domain name. So, if the user’s name is joe and the domain name is example.com, Joe’s login would be joe-example.
  7. Click Rename Now.

Deleting a domain

  1. Sign in to Virtualmin (see Account logins and important URLs).
  2. Select a domain from the drop-down in the left-hand navigation (your main domain should be already selected when you first login to Virtualmin). The domain you select will be the one that you’ll be renaming.
  3. Click Disable and Delete and click Delete Virtual Server.
  4. Click Yes, Delete It to delete the domain.