Home

From Gr88erWiki
(Redirected from Main Page)

Getting Started

How Do I Create A Client? (For Reseller only)

Now we have to differentiate between two scenarios:

  1. the client belongs to the admin
  2. the client belongs to a reseller.

In the first case, you must log in as admin and create the client from the admin account, in the second case you must log in as the reseller and create the client from the reseller account.

Then go to Client > Clients > Add Client. Fill in the address of the client on the Address tab and then go to the Limits tab to specify limits for the client.

After you have created the client, you can find it in the list under Client > Clients > Edit Client.

If you want to modify the client, you can pick it from that list and change the client's settings. From the list view, it is also possible to directly log in as the client and to delete the client.

How Do I Create A Web Site?

It is important that you create a client first before you create a web site so that you can assign the web site to that client (a client can own multiple web sites). Then log in as admin or as the reseller to which that client belongs and go to Sites > Websites > Website (see Website). To create a web site, you just need to fill out the Domain tab (the other tabs contain special configurations that you usually don't need). Make sure that you select the correct client in the Client drop-down menu (if you are logged in as admin, you can select all clients that exist on the system; if you are logged in as a reseller, you can select only the clients that belong to the reseller)

Use the Auto-Subdomain field to define whether you want no automatic subdomain for the web site (in this case you can access the site only by using the domain, e.g. http://example.com), an automatic www subdomain (recommended) (you can then access the site using http://example.com and http://www.example.com), or a wildcard subdomain (*.) which means you can access the site with any subdomain that does not point to another web site.

After you have created the web site, you can find it in the list under Sites > Websites > Website.

From the list view, it is possible to delete the web site.

If the DNS records for the new web site exist and point to the correct server, you can now go to the new web site in a browser, and you should see the default welcome page.

Important: if a client creates a web site himself, he has the permissions to modify the web site settings. If the admin or a reseller creates a web site for a client, then the web site settings cannot be modified by the client, only by the admin or by the reseller that created the web site.

How Do I Create An SSL Web Site?

To make a web site SSL-capable, please make sure that the SSL checkbox is checked on the web site's Domain tab (please note that you can have only one SSL web site per IP address). You can use * or an IP-Address in the IPv4 field as SNI is supported by all recent web browsers now.

Then go to the SSL tab (see Website).

On the SSL tab you can create a self-signed SSL certificate together with a certificate signing request (CSR) that you can use to apply for an SSL certificate that is signed by a trusted certificate authority (CA) such as Verisign, Comodo, Thawte, etc. It's not necessary to buy such a trusted SSL certificate, but you should note that if you use a self-signed SSL certificate, browsers will display a warning to your visitors.

Please note that you can have just one SSL web site per IP address.

To create a self-signed certificate, please fill out the fields State, Locality, Organisation, Organisation Unit, Country, and SSL Domain, and then select Create Certificate from the SSL Action drop-down menu, and click on Save. Leave the fields SSL Request, SSL Certificate, and SSL Bundle empty - the fields SSL Request and SSL Certificate will be filled out by the system.

After the self-signed certificate was created, you will find data in the SSL Request and SSL Certificate fields (it can take one or two minutes until the data appears in the fields).

It is already possible to access the web site using https:// now with the self-signed certificate, but your visitors will see a warning. For example, Firefox will complain about the self-signed certificate, therefore you must tell Firefox to accept the certificate - to do this, click on the I Understand the Risks or Extended / Erweitert link (depending on language an Firefox version).

Click on Add Exception...: and then Add Security Exception window opens. In that window, click on the Get Certificate button first and then on the Confirm Security Exception button.

Afterward, you should be able to see the https:// web site.

If you want to buy an SSL certificate from a trusted CA, you have to copy the data from the SSL Request field - this is the certificate signing request (CSR). With this CSR, you can apply for a trusted SSL certificate at your CA - the CA will create an SSL certificate from this CSR, and you can paste the trusted SSL certificate into the SSL Certificate field. Sometimes your CA will also give you an SSL bundle - paste this into the SSL Bundle field. Select Save Certificate from the SSL Action drop-down menu and click on the Save button.

You have just replaced your self-signed certificate with a trusted SSL certificate.

To delete a certificate, select Delete Certificate from the SSL Action drop-down menu and click on the Save button.

How Do I Create An FTP Account So That I Can Upload Files To My Web Site?

Go to Sites > FTP > FTP-User and click on the Add new FTP-User button (see Databases).

Select the web site for which you want to create the FTP user, then define a username for the FTP account ([CLIENTNAME] is a placeholder and will be replaced; you can see the final username in the FTP user list) and a password and specify a hard disk quota in MB (-1 means unlimited).

Afterward, you can find the new FTP user in the list under Sites > FTP > FTP-User (where you can also see the final username of the FTP user, defaulttom in this case which means that [CLIENTNAME] was replaced with default). The client name default is used when the website is assigned to the admin user and not to a client.

From the list view, it is possible to delete the FTP user.

You can now use the new FTP account to log into your web site (using an FTP client such as FileZilla) - use your web site domain (without http:// or https://) in the Server or Hostname field of your FTP client and then your FTP username and password to log in.

After you've logged in, you can now see the directory structure of your web site. You must upload web site contents into the web/ directory (or subdirectories of it) as this is the document root of your web site; Perl or CGI scripts must go into the cgi-bin/ directory.

Please note that Perl or CGI scripts that you upload into the cgi-bin/ directory must be executable; you can make them executable by changing the file attributes through your FTP client.

How Do I Create An Email Account?

The first thing we have to do is to add the domain of the email account to the system. To do this, go to Email > Email Accounts > Domain and click on the Add new Domain button. Fill in the domain name, select the correct client and enable the spamfilter for the domain, if desired.

Now we can create an email account for that domain. Go to Email > Email Accounts > Email Mailbox and click on the Add new Mailbox button. Select the domain and fill in an alias (i.e., the local part or the part before the @ sign). The Realname and Send copy to fields are optional. Fill in a password for the account, set a quota in MB (-1 means unlimited) and select a spamfilter level to use: Non-Paying, Uncensored, Wants all spam, Wants viruses, Normal, Trigger happy, Permissive. The settings for each of these levels are defined under Email > Spamfilter > Policy. Please note that this setting overrides the spamfilter setting of the mail domain (no matter what spamfilter level you chose for the mail domain; this is true even if you disabled the spamfilter for the mail domain), with one exception: If you choose to not enable the spamfilter for this email account, but the spamfilter is enabled for the mail domain, then the spamfilter setting of the mail domain is used for this email account. Use Uncensored to disable the spam-/virusfilter (see Email Mailbox).

After you have created the email account, you can find it in the list under Email > Email Accounts > Email Mailbox.

From the list view, it is possible to access the email account using a webmail application or to delete the email account.

Every new email account will automatically receive a welcome email.

How Do I Create A DNS Zone?

To create a DNS zone, it is recommended to use the DNS Wizard (DNS > DNS Wizard > Add DNS Zone) which will automatically create a set of common DNS records for your domain (like www, mail, ns records, etc.) (see Add DNS Zone).

Afterwards you can find the new zone in the list under DNS > DNS > Zones.

From the list view, it is possible to delete the DNS zone.

If you edit the zone and go to the Records tab, you will see the records that have automatically been created by the DNS Wizard (the Default template will create A records for mydomain.com, www.mydomain.com, and mail.mydomain.com, two NS (nameserver) records, plus an MX (mail exchanger) record for mydomain.com that points to mail.mydomain.com).

On the Records tab, you can edit or delete existing records and add further ones.

How Do I Create A Secondary DNS Zone?

If you've already created the master DNS zone for a domain on another server and would like to create the secondary zone for the domain on one of the servers, go to DNS > Secondary DNS > Secondary Zones and click on the Add new secondary DNS Zone button (see Secondary Zones).

Select the server and the client for the secondary zone, then fill in the domain for which you want to create the secondary zone in the DNS Zone field, e.g. someexampledomain.com. - please note that you need a dot at the end. Then specify the IPv4 address of the primary nameserver for the domain in the NS field, e.g. 1.2.3.4. Make sure that the Active checkbox is checked and click on Save.

Afterward, you can find the new zone in the list under DNS > Secondary DNS > Secondary Zones.

From the list view, it is possible to delete the secondary DNS zone.

HowTos

How Do I Import An Existing SSL Certificate Into A Web Site That Was Created Later?

Just copy your certificate, the key, the bundle certificate (if necessary) and the CSR (optional) into the respective text areas on the SSL tab of the web site and select Save Certificate under SSL Action and click on Save (see Website).

How Do I Redirect My Web Site To Another Web Site Or To A Specific Directory On The Server?

Go to the Redirect tab of your web site (see Website). In the Redirect Type field, please select the flag that you want to use for the redirect: Flags:

  • R: Use of the [R] flag causes an HTTP redirect to be issued to the browser. If a fully-qualified URL is specified (that is, including http://servername/) then a redirect will be issued to that location. Otherwise, the current servername will be used to generate the URL sent with the redirect.
  • L: The [L] flag causes mod_rewrite to stop processing the ruleset. In most contexts, this means that if the rule matches, no further rules will be processed.
  • R,L: You will almost always want to use [R] in conjunction with [L] (that is, use [R,L]) because on its own, the [R] flag prepends http://thishost[:thisport] to the URI, but then passes this on to the next rule in the ruleset, which can often result in 'Invalid URI in request' warnings.

More details about Apache rewrite flags can be found here: http://httpd.apache.org/docs/2.2/rewrite/flags.html

If you want to do a URL redirect, you should use the R,L flags, while for a directory redirect it is recommended to just use the L flag.

More details about Apache rewrite flags can be found here: http://wiki.nginx.org/NginxHttpRewriteModule#rewrite

If you want to do a URL redirect, you should use the permanent flag.

If you want to do a URL redirect, please specify the redirect target URL in the Redirect Path field (e.g. http://www.someotherwebsite.com/subdir/ or http://www.someotherwebsite.com/). Please note that the URL should have a trailing slash.

If you want to do a redirect to a subdirectory of your web site, please specify the subdirectory or the path to the subdirectory (relative to the document root of your web site) in the Redirect Path field. Please note that the path must begin and end with a slash (e.g. /subdirectory/anothersubdirectory/).

How Can I Use Perl/CGI Scripts With My Web Site?

First, you must check the CGI checkbox for your web site on the Domain tab.

Afterward, you can upload your Perl and CGI scripts to the cgi-bin/ directory of your web site (they will only work in that directory). Please note that you must make your Perl and CGI scripts executable (e.g. through your FTP client, see How Do I Create An FTP Account So That I Can Upload Files To My Web Site?) because otherwise, they will not work. Also, if you have enabled suExec (Apache) for your web site, the scripts must be owned by the correct user and group (which is already the case if you uploaded them through FTP).

How Do I Activate The Spamfilter/Virus Scanner For An Email Account?

When you create or edit an email account, you can select a spamfilter level to use: Non-Paying, Uncensored, Wants all spam, Wants viruses, Normal, Trigger happy, Permissive. The settings for each of these levels are defined under Email > Spamfilter > Policy. Please note that this setting overrides the spamfilter setting of the mail domain (no matter what spamfilter level you chose for the mail domain; this is true even if you disabled the spamfilter for the mail domain), with one exception: If you choose to not enable the spamfilter for this email account, but the spamfilter is enabled for the mail domain, then the spamfilter setting of the mail domain is used for this email account. Use Uncensored to disable the spamfilter (see Email Mailbox).

How Do I Blacklist/Whitelist Email Addresses In The Spamfilter?

To blacklist an email address in the spamfilter (which means that emails originating from that email address will always be considered spam), go to Email > Spamfilter > Blacklist and click on the Add Blacklist record button (see Blacklist).

Select the user or the whole domain that will benefit from this blacklist record in the User drop-down menu, and then fill in the email address that you want to blacklist in the Email field.

If multiple whitelist/blacklist records apply, the Priority field specifies which rule to use first (10 = highest priority, 1 = lowest priority). For example, if you blacklist @nastyspamdomain.com with a priority of 5, you could whitelist gooduser@nastyspamdomain.com with a priority of 6 so that gooduser@nastyspamdomain.com's mails get through while @nastyspamdomain.com is blacklisted. In most cases, you can disregard the Priority field.

Make sure that the Active checkbox is checked and click on Save.

How Do I Create A Subdomain And Redirect It To A Different Folder/Web Site?

Go to Sites > Websites > Subdomain for website (see Subdomain for website). In the Redirect Type field, please select the flag that you want to use for the redirect: Flags:

  • R: Use of the [R] flag causes an HTTP redirect to be issued to the browser. If a fully-qualified URL is specified (that is, including http://servername/) then a redirect will be issued to that location. Otherwise, the current server name will be used to generate the URL sent with the redirect.
  • L: The [L] flag causes mod_rewrite to stop processing the ruleset. In most contexts, this means that if the rule matches, no further rules will be processed.
  • R,L: You will almost always want to use [R] in conjunction with [L] (that is, use [R,L]) because on its own, the [R] flag prepends http://thishost[:thisport] to the URI, but then passes this on to the next rule in the ruleset, which can often result in 'Invalid URI in request' warnings.

More details about flags can be found here: http://httpd.apache.org/docs/2.2/rewrite/flags.html

If you want to do a URL redirect, you should use the R,L flags, while for a directory redirect it is recommended to just use the L flag.

If you want to do a redirect to a subdirectory of your web site, please specify the subdirectory or the path to the subdirectory (relative to the document root of your web site) in the Redirect Path field. Please note that the path must begin and end with a slash (e.g. /subdirectory/anothersubdirectory/):

Troubleshooting