How To Install and Configure ZPanel on an Ubuntu 12.04 VPS

What is ZPanel?


One popular web interface for managing servers is ZPanel. Using this control panel, you can access some of the functionality traditionally reserved for the command line, from within a web browser.

In this guide, we will discuss how to install ZPanel on an Ubuntu 12.04 VPS. We will start from a clean droplet. The installation will install and configure the necessary web server software.

Requirements


Before we begin, we need to prepare our server.

Log into your VPS as a user with sudo privileges. Update the package database and install “curl” by using the following commands:

sudo apt-get update
sudo apt-get install curl

The curl utility is needed to download the necessary dependencies during the installation.

How To Download ZPanel on Ubuntu 12.04


We will download the ZPanel installation script from the project’s website.

There are installation scripts for both the 32-bit and 64-bit versions of Ubuntu.

Use the following commands if you are running a 32-bit version of Ubuntu:

cd
wget https://github.com/bobsta63/zpanelx/releases/download/10.1.0/installer-10-1-0-ubuntu-32.sh.x
chmod +x installer-10-1-0-ubuntu-32.sh.x

Run these commands if you are running a 64-bit version of Ubuntu:

cd
wget https://github.com/bobsta63/zpanelx/releases/download/10.1.0/installer-10-1-0-ubuntu-64.sh.x
chmod +x installer-10-1-0-ubuntu-64.sh.x

How To Install ZPanel on Ubuntu 12.04


Run the installer with administrative privileges with the following command:

sudo ./installer-10-1-0-ubuntu-*

The installation script will begin.

Answer “y” to accept the GPL licensing agreement.

Next, you will be asked which timezone your server should adhere to.

You should enter your timezone as one of the values specified on the PHP timezone page. Click on your region, and then select the appropriate zone.

For our guide, we will assume you are in the New York timezone. You would enter the timezone like this:

America/New_York

The next step will ask you to enter the domain that you will use to access the ZPanel admin interface.

If your domain is “example.com” and you would like to configure ZPanel from “zpanel.example.com”, you could enter the this into the prompt:

zpanel.example.com

If you need help configuring your domain with DigitalOcean, click here. Make a DNS record for the subdomain you use during this step.

Enter your Public IP address. It may be auto-populated.

Finally, type “y” to continue with the installation.

How To Access ZPanel Through the Web Interface


How To Get the Authentication Information


At the end of the installation, the server will be rebooted in order to implement the necessary changes.

Log into the server again to get the password information. Type the following command to get access to the information:

sudo less /root/passwords.txt
zadmin Password :: HqxWgERUXcCpucXN
MySQL Root Password :: hpNmPHlInekX7880
MySQL Postfix Password : YzcCLClovWUzDFh1
Ip Address :: xxx.xxx.xxx.xxx
Panel Domain :: zpanel.example.com

The “zadmin Password” line is the field needed to authenticate with the server.

Logging Into the Interface


Open a web browser and navigate to the administration sub-domain you configured during installation. In our example, this would be:

zpanel.example.com

ZPanel Authentication Page

Use the following information to sign in:

Username: zadmin
Password: password_from_passwords.txt_file

You will now have access to the administration panel.

ZPanel admin page

How To Configure Domain Names with ZPanel


At this point, you should already have DNS records set up for:

    • your domain name (example.com in this guide)

 

    • your zpanel subdomain (zpanel.example.com for our purposes)

We have already see that if you visit “zpanel.example.com”, you will get the configuration page, as expected.

However, you are also taken to the configuration page if you visit “example.com”. This is not what we want.

How To Set Up Domain and Sub Domains


We need to replicate the domain information within ZPanel so that it can direct traffic correctly.

Begin by clicking “Domain” in the top navigation bar, and then selecting “Domains” from within the menu.

ZPanel Domain page

In the “Domain name” field, enter the name of your domain.

Select “Create a new home directory” and click “Create”.

Next, click on “Domain” in the top navigation bar, and then select “Sub Domains” from the menu:

ZPanel Sub Domain page

Enter the name you have been using to access the ZPanel control page. In our page, this is “zpanel.example.com”.

Click “Create a new home directory” and then choose “Create” to make enable these adjustments.

How To Upload Your Site Content


To upload the content to your server, you need to create an FTP account that you can use remotely.

Click on “File” in the upper menu bar, and then click “FTP Accounts”.

ZPanel FTP Accounts

Choose a Username and Password. These do not have to match previous values you selected for use within ZPanel.

Change the Access Type to “Full access”. Select “Use Domain directory” and pick the name of your base site (example.com). Click “Create”.

In your FTP client, use the credentials you just created in order to log into your server. Upload your site content to the folder matching your domain name.

Note: ZPanel changes dots to underscores when creating directories for domains. So a site named “example.com” would reside in a folder called “example_com”.

When you are done, navigate to your domain to see the files you have just uploaded:

example.com

ZPanel main domain

Basic ZPanel Configuration


How To Change Your Password


One of the first things you may wish to do is change the password.

In the upper-right corner, click on “Account”. The first option will be “Change Password”:

ZPanel Password Page

In the resulting page, enter your current password, and then fill in and confirm your new password.

How To Remove the Notice on Top


By default, there will be a blue notice that shows up on every page you visit.

ZPanel default notice

You can remove this by clicking “Reseller”. The first option will be “Client Notice Manager”:

ZPanel Notice manager page

Clear out the text from the box and click “Save changes”.

Conclusion


ZPanel is an easy way to administer servers from a centralized location. It can speed up the process of creating and modifying many common tasks and can be used to delegate selected responsibility to other users.

Revisions

No comments yet.

Leave a Reply