<.
# About ZPanel #
Just Vigilantes use the ZPanel Control Pannel, ZPanel is a system that helps in the day to day tasks involved in administration of a typical website on the internet. Its goal is to simplify running web and email hosting across multiple, separate domains, along with all their associated services. Specifically, ZPanel allows you as a user:
+ Web site configuration, including uploading content via FTP
+ Email configuration, including web mail
+ Database access
+ Automatic daily backups
## Is there a Web Interface?
Yes, All typical day-to-day jobs, such as adding new web sites, or email addresses, can be done by going to the panel at [panel.justvigilantes.com](http://panel.justvigilantes.com/index.php) or uploading content, can be done using FTP. [ForkLift](http://www.binarynights.com/) is a recommended program for this.
## Is ZPanel free software?
Yes! ZPanel is both Free Software and Open Source software. you can find full details on the [ZPanel CP site](zpanelcp.com)
ZPanel is a web-based web hosting control panel that runs on top of Apache, PHP and MySQL.
ZPanel integrates with various open-source and cross platform applications and servers enabling ZPanel to be compatible with various platforms and applications:
+ Apache Web Server
+ Postfix MTA
+ Dovecot IMAP/POP3
+ ProFTP Daemon
+ MySQL
+ PHP
+ Webalizer
+ RoundCube
+ phpMyAdmin
+ phpSysInfo
## About This Documentation ##
What follows is step by step instructions to get up and running with controlling your server and setting up core services. The screen shots are taken from a Mac OS X Mountain Lion system, but all the programs used are also available for Mac OS X and GNU/Linux desktop systems.
Throughout the documentation, the example server used is [JustVigilantes.com](http://justvigilantes.com) (ZPanel at 10.0.1 running on Centos). The example domain used is __my-brilliant-site.com__. These should be substituted as appropriate.
# Setup to Your Hosting #
In this chapter you’ll learn how to setup your server, and then how to transfer files using the ForkLift program.
![Welcome Email; showing Username and Password][WelcomeEmail]
Going to [panel.justvigilantes.com](http://panel.justvigilantes.com)
![Login Screen][LoginScreen]
After you have logged in you will see the ZPanel Control Panel Main Screen:
![ZPanel Control Panel Main Screen][MainScreen]
[WelcomeEmail]: ./welcomeemail.png
[LoginScreen]: ./login.png
[MainScreen]: ./mainscreen.png
## Website Setup ##
We want to set up my-brilliant-site.com so that the website works; to do this we log into the control panel,
We will first add the domain my-brilliant-site.com to the server.
![Select Domains from the Domain menu.][AddingDomain1]
![Type my-brilliant-site.com into Domain name box, and select create a new home directory, then Click create.][AddingDomain2]
![You will now see the new domain marked as Pending, it will take about an hour for it to set it up fully.][AddingDomain3]
Next will need to make the DNS records for your domain my-brilliant-site.com
![Select DNS Manager from the Domain Menu.][DNSManager1]
![Choose my-brilliant-site.com on the drop down menu and click select.][DNSManager2]
![There are no DNS records for this site, so we will need to create them. Click Create Records][DNSManager3]
![DNS Records have now been created.][DNSManager4]
If you need to set up the name servers on 123-Reg or another registry you can use Just Vigilantes default name servers (ns1.justvigilantes.com and ns2.justvigilantes.com).
![Name Servers for PhilipMcGaw.co.uk on 123-Reg showing use of ns1.justvigilantes.com and ns2.justvigilantes.com.][123-Reg]
If you now visit my-brilliant-site.com in your browser you will see the following page:
![Your hosting space is ready…][Working80]
[DNSManager1]: ./dnsmanager1.png
[DNSManager2]: ./dnsmanager2.png
[DNSManager3]: ./dnsmanager3.png
[DNSManager4]: ./dnsmanager4.png
[123-Reg]: ./123-reg.png
[Working80]: ./working80.png
[AddingDomain1]: ./addingdomain1.png
[AddingDomain2]: ./addingdomain2.png
[AddingDomain3]: ./addingdomain3.png
## FTP Setup ##
Goto FTP Accounts on the File menu
![FTP Accounts Menu.][FTP1]
![Set up the username and password, Access Type, and Home Directory.][FTP2]
![This page will show you all the accounts setup.][FTP3]
[FTP1]: ./FTPsetup1.png
[FTP2]: ./FTPsetup2.png
[FTP3]: ./FTPsetup3.png
### Connecting to My-Brilliant-site.com via FTP ###
![ForkLift's main page.][Forklift1]
![Enter the settings from the previous section.][Forklift2]
![Connected.][Forklift3]
Once you are connected you can upload your own webpages to the site. you will need to put them in the folder public_html/my-brilliant-site_com and replace the existing index.html
![It Works!][Working801]
[Forklift1]: ./forklift1.png
[Forklift2]: ./forklift2.png
[Forklift3]: ./forklift3.png
[Working801]: ./working801.png
## Setup Email ##
This chapter deals with configuring email for a domain, namely setting up mailboxes to receive email. The ZPanel system makes this very simple, as the process of creating a new mailbox, or email account.
As with our previous examples we’ll be using the my-brilliant-site.com domain for demonstration purposes, but you should substitute your own domain.
Again for example purposes we’ll be demonstrating the creation of a new email account, for the user "bob", which will correspond to the email address bob@my-brilliant-site.com - you should change the name "bob" to the username(s) you desire.
![Click on the Mailboxes link in the Mail menu.][Mailboxes1]
![Type in bob, choose "@my-brilliant-site.com" and give him SomePassword, then click Create.][Mailboxes2]
![Here you can manage previous email addresses.][Mailboxes3]
[Mailboxes1]: ./mailboxes1.png
[Mailboxes2]: ./mailboxes2.png
[Mailboxes3]: ./mailboxes3.png
### Set Up Forwards ###
If you would prefer to have emails to a new address sent on to a different email address, lets say info@my-brilliant-site.com should be sent to bob, create an info mailbox in the same way as bob's email address was made, then:
![Click on the Forwards link in the Mail menu.][Forwards1]
![Select info@my-brilliant-site.com and set up bob as the Destination, remember to un-click Keep Original Message.][Forwards2]
[Forwards1]: ./forwards1.png
[Forwards2]: ./forwards2.png
### Testing a New Mailbox, via Webmail ###
Although most users will prefer to receive and write their emails using a dedicated client (such as ThunderBird, or Microsoft Outlook) the ZPanel system includes a mail client you can access with nothing more than a web-browser.
1. To log in to webmail, start your browser and head to [panel.justvigilantes.com/etc/apps/webmail/](http://panel.justvigilantes.com/etc/apps/webmail/).
1. Enter your email address in the Name field, and your password in the Password field.
### Configuring Email Clients ###
The following details might be needed when setting up a mail client to use an email account. The user of bob@my-brilliant-site.com on the machine JustVigilantes.com has been chosen for these worked examples.
Incoming email can be collected using either the IMAP or POP3 protocols. IMAP is generally recommended over POP3 as it can handle folders, push notification, can selectively download message parts, and the email remains on the server enabling back-ups to be made.
Outgoing email is sent using SMTP.
Managing sieve filters is done using the ManageSieve protocol (Can be set up via [Webmail][testinganewmailboxviawebmail]).
For both sending and receiving email, and managing sieve filters, the following login information would be used.
|Name | Value |
|---------- | ------------- |
|Description | Bob's Email |
|Email Address | bob@my-brilliant-site.com |
|Full Name | Bob |
|Account type | IMAP |
|Incoming Server | my-brilliant-site.com |
|Username | bob@my-brilliant-site.com |
|Password | SomePassword|
|Authentication | Password |
|SSL? | There is no SSL |
|Account type | SMTP |
|Outdoing Server | my-brilliant-site.com |
|Username | bob@my-brilliant-site.com |
|Password | SomePassword |
|Description | Bob's Email |
|SSL? | There is no SSL |
|Authentication | Password |
|Webmail | [webmail](http://panel.justvigilantes.com/etc/apps/webmail/) |
On your Mac, open Mail, and then Mail > Preferences… > Accounts > then Little Add Button >
![Settings for IMAP, then click Continue.][Mail1]
![Click Continue.][Mail2]
![Settings for SMTP, then click Continue][Mail3]
![Click Continue.][Mail4]
![Check all is correct, then click Create.][Mail5]
You have just set up email on your Mac; If you want to set up mail on your iPhone you can set it up by going to Settings > Mail, Contacts, Calendars > Add Account… > Other > and using the same settings as for the Mac.
[Mail1]: ./mail1.png
[Mail2]: ./mail2.png
[Mail3]: ./mail3.png
[Mail4]: ./mail4.png
[Mail5]: ./mail5.png
]]>