Tutorial

How To Install the Sentora Web Hosting Control Panel on Ubuntu 14.04

Published on April 27, 2015
How To Install the Sentora Web Hosting Control Panel on Ubuntu 14.04

Introduction

In this tutorial, we will demonstrate how to install Sentora, a free open source web control panel, which is easy to install and maintain. By the end of this tutorial we will have a working webserver, email account, and landing page for one of your domains.

Prerequisites

To follow this tutorial, you will need:

Step One — Installing Sentora

In this section, we will install the Sentora control panel.

SSH into your Droplet as root and start the installation by running the following command.

bash <(curl -L -Ss http://sentora.org/install)

You’ll be prompted to choose your geographic area and then the city or region the server timezone should be set in. Use the arrow keys to scroll up and down, then press ENTER to proceed once your choice is highlighted.

After selecting your time zone, you will be prompted to enter a domain to access your control panel. This should not be your main domain! Use a subdomain, such as panel.example.com.

Enter the sub-domain you want to access Sentora panel: panel.example.com

Then press ENTER. Next you will be asked to confirm the IP address of your server.

Enter (or confirm) the public IP for this server: your_server_ip

Double check it is correct and press ENTER again to continue.

Note: You may get a warning such as:

WARNING: panel.example.com is not defined in your DNS!

This is fine; we will set up DNS records in the next step. Enter y to continue.

The installation process may take some time. Please be patient as it installs the necessary components onto your server.

When the installation is almost done, you will be prompted to reboot your server to complete it. Enter y. Once your server reboots, you will have to SSH back in again.

Step Two — Setting Up DNS

Setting up your DNS is relatively simple, but the steps may vary between DNS servers. Go to the DigitalOcean DNS panel, fill out your domain name in the provided box, and press the Add Domain button:

Add base domain in DigitalOcean DNS control panel

On the next screen, add an A record by typing the subdomain you chose during installation into the HOSTNAME box. For example, if you chose panel.example.com in the installer, enter panel in this box. In the WILL DIRECT TO box, enter the IP address of your server or select your Droplet from the menu:

DigitalOcean DNS add A record

Press the Create Record button.

Next, select the MX record type. In the HOSTNAME box, type @. In the MAIL PROVIDERS MAIL SERVER box, type the full domain you added (e.g. panel.example.com). In the PRIORITY box, enter 10. Press the Create Record button when you are done:

DigitalOcean DNS add MX record

Next, select the TXT record type. In the HOSTNAME box, type @. In the VALUE box, enter:

v=spf1 a mx ip4:your_server_ip ~all

Click the Create Record button when you are finished:

DigitalOcean DNS add TXT record

This ensures that mail you send is not recognized as spam by the receiver. After entering that, click Create.

Your DNS zones should look like:

Zone File Picture

And the zone text below should look look similar to this:

Step Three — Changing the Admin Password

In this step, we will log in to Sentora and update the admin password.

Using your favorite web browser, navigate to http://panel.example.com, and you will reach the Sentora login screen. The default username is zadmin. To get the password, SSH back into your Droplet if you haven’t already and enter the following command.

cat /root/passwords.txt

Look for the line that begins with zadmin Password:. Copy the password and use that to log in.

Once you are logged in, you should change your password. In the main panel, inside the Account Information box, click Change Password. Enter the original password you used to log in and a new password, then click Change. You can use your new password to log in to your control panel from now on.

Step Four — Using the Sentora Control Panel

In this step, we will create a website and set up an email address.

Creating a Website

Now we can add a website. Return to the main panel by click Home at the top of the screen.

Inside the Domain Management box, click Domains. You will be greeted with a form to add a domain name. In the Domain Name box, enter your domain name, example.com. Press the blue Create button to add your domain.

Next, click Home in the top navigation bar. Inside the File Management box, click FTP Accounts. In the form that appears, enter your desired username and password in the Username and Password boxes. These credentials will be used to login to your FTP servers, to upload and download files to and from your server. In the Access Type drop down menu, select Full Access. In the Home directory radio options, select Set master home directory. In the drop down box that appears, make sure / (root) is selected, then click the blue Create button.

Now visit example.com. You should see a Sentora-generated page which says Your hosting space is ready… at the top.

Note: Sentora only supports FTP to upload files you want to show on your website. FTP is insecure, as it transmits usernames and passwords in plaintext. You can read this tutorial for information on FTP security and FileZilla, a popular file transfer tool. However, you can manually add files to /var/zpanel/hostdata/zadmin/public_html/example_com to add them to your website.

Setting Up Email

In the main panel, inside the Mail box, click Mailboxes.

In the text box next to Email address: enter an email username (this will go before the @). In the drop down box, select the domain you added, example.com (this will go after the @). In the Password field, enter your desired password.

After you set up your email, you can access the webmail client either by clicking Webmail in the control panel homepage, or at http://panel.example.com/etc/apps/webmail/. Use the email address you just chose as the username and the password you entered.

Conclusion

Now that you have the Sentora control panel set up on your Droplet, you can spend some time to take a look around your new control panel. Updating Sentora to new versions is easy with the Updates module.

Sentora has many more features, including MySQL, Webalizer, backups, and even the ability to make user and reseller accounts.

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Learn more about our products

About the author(s)

Jonah Aragon
Jonah Aragon
See author profile
Category:
Tutorial

Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?
 
31 Comments
Leave a comment...

This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

Nice!

I’m using sentora and works fine but I can’t figure out how to set up an email client such as thunderbird with my e-mail boxes.

I’have tried the settings according the official doc says but nothing works. Did anyone faced with this?

First of all: Awesome tutorial! I’ve set thing up nice and smoothly, thanks.

I’ve been trying to setup my email client up also, like dannystyleart. Despite all of the good tutorials, i can’t seem to find one about setting up the email client. POP3 or IMAP works with the email client, but the SMTP doesn’t. It would be awesome if such tutorial gets released… I’m trying for a few weeks now, with no result…

Thanks

After struggling for a while, i managed to solve the e-mail issue with clients such as Outlook, Thunderbird etc…

Log into your server using SSH, and open the following file:

sudo nano /etc/postfix/master.cf 

Next, add this line:

submission inet n - n - -  smtpd

CTRL + O to save, and CTRL X to exit. Now restart the postfix server using the following command:

sudo postfix restart

Now your settings should be working fine. Make sure you use this configuration while setting up your email in your email client:

Port: 587 Use SMTP with authentication! (same as POP or IMAP)

Goodluck.

Your fix here is cool, I’ll test this out and see if I can update the tutorial, as I was having this issue myself on my installation after I posted this :)

Hi. regarding setting up the panel.example.com. i am sure i’ve already pointed OceanDigital to my domain DNS, and typed in panel.mydomainname.com in the Enter the sub-domain you want to access section. However the Sentora login screen loaded in mydomainname.com instead of panel.mydomainname.com. Please kindly assist. Thank you

Sorry for the late reply. When you make a website on mydomainname.com in Sentora that will take over and the panel will go away from that domain :)

Is this guide for beta version? or final product version of Sentore?

I’ve been using Sentora Beta for over 6 months now. But I need stable version to install SSL on one of my websites. Therefore, I need fresh install for stable version.

Hope this guide is the same.

Looking at the Sentora docs, it looks like the install for the stable version is the same, so this tutorial should work. I’ll try installing a stable version to make sure the process hasn’t changed.

thanks trying now after purging the old one. I’ll inform results. thanks for the guide again.

Great tutorial! Everything is working very smoothly :)

working smoothly tried yesterday.

@jonaharagon have you ever installed SSL on sentora domains. I’ve purchased SSL from godaddy but unable to implement SSL certificated on sentora? pls help. I’ve tried apache config override many times but no result.

thanks in advance.

I haven’t done it no. Check out the docs here and see if it works: http://docs.sentora.org/?node=64

If it still doesn’t then I can try to figure it out myself, and post results.

Glad this worked for you!

Thank for your tutorial. Can anyone assist to config the email system like this:

SMTP: mail.yourdomain.com POP3: mail.yourdomain.com IMAP: mail.yourdomain.com

Then how to config to access the webmail with: webmail.yourdomain.com

Thank all.

create the webmail.yourdomain.com subdomain, edit the index.php file, redirecting to http://panel.yourdomain.com/etc/apps/webmail/ … and voilá!

Dear Clientesrefacci,

I’m quite new with this. Can you give me more detail information? Where is index.php file locate? I found many index.php files. Thank you!

This comment has been deleted

    Create A records for the mail.domain.com A mail IN 0.0.0.0

    VirtualHost for webmail subdomain: forums. sentora .org/showthread.php?tid=495 (Remove all spaces!!) Post #2 is for Linux

    Create A records for the mail subdomain. Check this thread on Sentora Forums for VirtualHost: http://forums.sentora.org/showthread.php?tid=495

    I have been done install the sentora into my ubuntu server. please help how to change Setting Up DNS because I cannot access the first domain?

    Thanks for the tutorial, looks like everything is working which is amazing. I’ve tried dozens of panels and articles and this is the first time when I got things working!

    On the FTP and unsecure access I have a suggestion to use SFTP which is basically SSH. For example Transmit for Mac can connect via SFTP and it has the security of SSH and the visuality of FTP

    Does anyone have a clue on how to update the panel to a new version? (Right now 1.03 is out, I’m still on 1.0)

    Thx!

    If i want to use nginx instead of apache then how can i configure that? I think in this tutorial we are Installing Sentora with a apache package. But their is no clue how to install sentora with nginx. Anyone can help?

    This comment has been deleted

      This comment has been deleted

        Hello,

        When i bash <(curl -L -Ss http://sentora.org/install) : I have this error :

        bash: /dev/fd/63: No such file or directory
        

        Thanks for your help !

        can I use sentora for multi domain ?

        Awesome write up, I do have a question about DNS and Subdomains. Can I solely use Sentora to manage DNS or do I still have DigitalOcean’s DNS Panel?

        can be use only de DNS sentora part? can you confirm.

        How to upgrade PHP version?

        This comment has been deleted

          I am having issues adding multiple domains to my Sentora account. Do I still have to add the domain to digital ocean to create a record or should I just be able to use the one in Sentora to add a domain and create a DNS record?

          Should i need to setup all the domains in Sentora CP as well, which are already setup in DO. Apparently Sentora did not import the domains data from DO zone file. Can somebody help ?

          How to add second domain on sentora digitalocean?. i must edit ns also on digitalocean dns?

          I have the same question?

          I was able to get multiple domains working by adding the domain to Digital Ocean and then adding it to Sentora as well.

          Hello everyone. I made all the settings and everything worked to arrive in the mail. The emails are coming, but not consido send. I bastente changes found on the Internet, but none successfully. Excludes my droplet and retraced every step by step again. I do not know if it’s some problem with SMTP configuration, MX, port, Postfix configuration. Can anyone give me a light?

          On ubuntu 16.04 you will get the following error message: Sorry, this OS is not supported by Sentora.

          Great! very impressed … everything worked the first time (luckily i remembered, which i haven’t always in the past, TO START WITH A CLEAN INSTALL OF UBUNTU … remember guys it needs to be a fresh install … before you start down the path of installing Sentora …) … so far i have had no problems setting up email, creating databases and using phpmyadmin (oh, … remember: you have to create the database first, add a user, then and only then can you login to phpmyadmin … you do those first two steps in the control panel itself …

          Very Nice tutorial, Thanks…

          if i install sentora control panel in ubuntu 16 , it said os not supporting

          This comment has been deleted

            Instructions works great! Just a small edit:

            • after setting everything up, and only the panel works instead of the main website, add a new A record in DO. “www” that points to the IP. Give it a minute, and it should load properly!

            Thank you for the tutorial. I followed all the steps, somehow, Sentora is installing without Configuration Package step. And assigning dummy access url. I tried multiple times and I keep haing the same problem. I get a flashing dash, and nothing happens whatever command I type. I’m new to this. Thank you.

            Join the Tech Talk
            Success! Thank you! Please check your email for further details.

            Please complete your information!

            Become a contributor for community

            Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

            DigitalOcean Documentation

            Full documentation for every DigitalOcean product.

            Resources for startups and SMBs

            The Wave has everything you need to know about building a business, from raising funding to marketing your product.

            Get our newsletter

            Stay up to date by signing up for DigitalOcean’s Infrastructure as a Newsletter.

            New accounts only. By submitting your email you agree to our Privacy Policy

            The developer cloud

            Scale up as you grow — whether you're running one virtual machine or ten thousand.

            Get started for free

            Sign up and get $200 in credit for your first 60 days with DigitalOcean.*

            *This promotional offer applies to new accounts only.