Tutorial

How To Install the Ajenti Control Panel and Ajenti V on Ubuntu 14.04

Published on June 26, 2015
How To Install the Ajenti Control Panel and Ajenti V on Ubuntu 14.04

Introduction

Ajenti is an open source, web-based control panel that can be used for a large variety of server management tasks. It can install packages and run commands, and you can view basic server information such as RAM in use, free disk space, etc. All this can be accessed from a web browser. Optionally, an add-on package called Ajenti V allows you to manage multiple websites from the same control panel.

In this tutorial we will be installing the Ajenti control panel for server management and the Ajenti V add-on module that allows the creations of websites and email accounts from inside the panel.

Ajenti Control Panel Homepage

Prerequisites

Before you can install Ajenti, you need:

All the commands in this tutorial should be run as a non-root user. If root access is required for the command, it will be preceded by sudo. Initial Server Setup with Ubuntu 14.04 explains how to add users and give them sudo access.

Installing Ajenti

In this step, we will install the Ajenti core panel. To begin, connect to your server with SSH.

On your server, as a user with sudo access, first add the repository key. This is used to validate the sources of the Ajenti packages you will be installing.

  1. wget http://repo.ajenti.org/debian/key -O- | sudo apt-key add -

Then add the actual repository to your sources list:

  1. echo "deb http://repo.ajenti.org/ng/debian main main ubuntu" | sudo tee -a /etc/apt/sources.list

Now you can update your packages and begin the install process by running:

  1. sudo apt-get update && sudo apt-get install ajenti

When it prompts you to continue, type Y and press ENTER. The install process may take a few minutes. After the process is over, start the Ajenti server:

  1. sudo service ajenti restart

If all goes well, the last line in your console should say * started. You can continue to the next step.

Configuring Ajenti

Here we will make a few important starting modifications to your control panel. Open a web browser and browse to https://panel.your_domain_name:8000/. If you did not configure a registered domain name to point to your Droplet as panel.your_domain_name, you will need to go to https://your_server_ip:8000/ instead.

Note: You will get a privacy error (a red lock in Chrome). This is completely normal because Ajenti uses a self-signed certificate by default. There is no reason to change this, and your connection is still secure.

In Google Chrome, click the Advanced link on the Privacy error page, and then click Proceed to panel.example.com.. Once again, this is not unsafe.

Log in with these default credentials:

Username: root

Password: admin

You will now be inside your new Ajenti control panel.

Ajenti Control Panel

Before we do anything else, click the Password option in the sidebar. Under old password type admin and then set a new password. From this moment on, to log into your control panel you will use:

Username: root

Password: your_new_password

Now click the Configure option in the left sidebar, it will be right above Password. Scroll down to the bottom, and click the Restart button. When it prompts you to restart Ajenti, click OK. This is restarting the Ajenti service. While it is doing so, your browser will display Reconnecting.... If this goes on for more than a minute, refresh your browser page.

After it restarts, log in with your new credentials and proceed to the next step.

Customizing Ajenti

The main page in Ajenti is the dashboard, and it can be customized to serve lots of useful and relevant information in an easy to read manner. By default a few widgets are already shown such as CPU Usage and Uptime. More widgets can easily be added by clicking the Add Widget button in the top right corner of the screen.

Add Widgets Menu

Plugins

Ajenti already has a lot of functionality built in by default, but if you want even more settings and configurable items in your panel, you can check out the Plugins section. Some plugins are enabled by default, while others aren’t, usually due to unsatisfied dependancies.

You can install disabled plugins by clicking on them in the Plugins menu and pressing the button next to the dependency it requires. Otherwise, if you later install an application manually and Ajenti has a plugin for, you can restart Ajenti and the corresponding menu should appear next time you log in.

System Management

Under the System section in the sidebar, there’s a plethora of configurable items to choose from. You can manage hard drives with the Filesystems menu, change the nameservers of your Droplet in Nameservers, add any packages and applications you’d need in the Packages section, and much more.

Filesystems menu: Filesystems

Nameservers menu: Nameservers

Users menu: Users

Packages menu: Packages

Installing Ajenti V to Setup a Website

Optionally, you can now install Ajenti V, which will allow you to make a website. In your Ajenti control panel on the left sidebar, click the Terminal option. It’s located under the Tools section. This terminal functions as a terminal emulator in your browser for direct access to your server. Click + New at the top of the screen, and click the middle of the empty black box that appears. This will open up the terminal. It may take a moment to load.

Note: Commands run in the Ajenti terminal will be run as the root user.

Towards the bottom of the screen there is a box labeled Paste here. Click inside that and paste the following command into that box:

  1. apt-get install ajenti-v ajenti-v-nginx ajenti-v-mysql ajenti-v-php-fpm ajenti-v-mail ajenti-v-nodejs php5-mysql

Then press ENTER. When prompted whether or not to install the packages, type Y, and then press ENTER again. Some popups may appear on the screen such as this:

Ajenti V Installation

For prompts such as these, just press ENTER for the options that are preselected. No configuration is required. MySQL may ask you multiple times to enter a root password. Press ENTER when it asks to keep the current password, which is fine for the purposes of this tutorial.

When it finishes, click the X next to Terminal 0 at the top of the screen to return to the home. Go back to the Configure menu from the sidebar, and restart Ajenti with the button at the bottom of the screen. You will need to log in again.

When Ajenti restarts, you should see a Web section in the sidebar and a Websites option immediately below that. From the Websites view you can add and manage websites as well as monitor your configuration to make sure everything is working properly.

The Websites menu

##Conclusion

Ajenti and Ajenti V are now installed on your server. To learn how to use some of their features, check out the following tutorials:

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

Learn more about us


Tutorial Series: Using the Ajenti Control Panel with Ajenti V

Ajenti is an open source, web-based control panel that can be used for a large variety of server management tasks. It can install packages and run commands, and you can view basic server information such as RAM in use, free disk space, etc. All this can be accessed from a web browser.

Optionally, an add-on package called Ajenti V allows you to manage multiple websites from the same control panel and easily configure email accounts for your domains.

About the authors

Default avatar
Tammy Fox

editor


Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?
 
10 Comments


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!

I have installed Ajenti but I cannot access the panel at all. I tried https://my_droplet_IP:8000 and it can’t find the site. What’s wrong?

Not working for me. After I install and do sudo service ajenti restart there’s no “* started” line, and if I go to https://panel.your_domain_name:8000/ or https://panel.your_server_ip:8000/ I get “page not found”.

Could this be because I have Wordpress installed already?

I had to use python-pillow and its python-imaging plugin instead on Ubuntu 19.

However, I couldn’t manage to get ajenti-v-mail installed, since it also requires courier-imap-ssl as a dependency, and that I couldn’t install!

Thanks for this article. Any update about Ubuntu-18.04?

If it’s not working with SSL certificate installed run:

ufw allow 8000
sudo service ajenti restart

I know it’s not explicitly necessary, but if I wanted to replace the self-signed certificate with one from Let’s Encrypt, how would I got about doing so?

If you are trying to install in ubuntu 16.04 : Please add this :

wget http://launchpadlibrarian.net/109052632/python-support_1.0.15_all.deb sudo dpkg -i python-support_1.0.15_all.deb

And Control panel might not be visible after logging for that please do this:

Go to

usr/share/pyshared/socketio/transports.py usr/share/pyshared/socketio/handler.py

change

(“Access-Control-Max-Age”, 3600), changing it to (“Access-Control-Max-Age”, “3600”),

sudo service ajenti restart

And for php 7:

sudo apt-get install ajenti-v ajenti-v-nginx ajenti-v-mysql ajenti-v-php7.0-fpm ajenti-v-mail ajenti-v-nodejs php7.0-mysql

sudo service ajenti restart

Installed and everything went fine, but not working with both domainname.com:8000 and panel.domainname.com:8000, also I’ve tried with the IP and it’s not working

My website does not load. I have everything installed correctly.

https://cakegamesmc.net:8000/

I’m running into an issue with https on hosted sites (not the control panel itself). They’ve all stopped working and the browser error is “ERR_CONNECTION_RESET”. This seems to have occurred after an update. Non SSL is working fine. Ubuntu version is 14.04.3.

Try DigitalOcean for free

Click below to sign up and get $200 of credit to try our products over 60 days!

Sign up

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

Please complete your information!

Get our biweekly newsletter

Sign up for Infrastructure as a Newsletter.

Hollie's Hub for Good

Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.

Become a contributor

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

Welcome to the developer cloud

DigitalOcean makes it simple to launch in the cloud and scale up as you grow — whether you're running one virtual machine or ten thousand.

Learn more
DigitalOcean Cloud Control Panel