Home MySQL Install phpMyAdmin With LAMP Stack On Ubuntu 18.04 LTS

Install phpMyAdmin With LAMP Stack On Ubuntu 18.04 LTS

By sk
Published: Updated: 11.3K views

PhpMyAdmin is a free and open source web-based database management tool written in PHP. It allows the database administrators to easily manage single and/or multiple database servers either from a local or remote system via a web browser. This can be useful for those who are not comfortable with MySQL prompt. Using phpMyAdmin, we can do all sorts of database management tasks such as creating, editing, renaming, deleting databases, import and export databases, create tables, fields and fields, execute SQL commands and many. In this tutorial, we will see how to install phpMyAdmin with LAMP stack on Ubuntu 18.04 LTS server operating system.

Install phpMyAdmin With LAMP Stack On Ubuntu 18.04 LTS

Before installing phpMyAdmin on your Ubuntu 18.04 LTS server, make sure you have setup LAMP stack as described in the link below.

Also make sure you've changed the password authentication method for mysql root user as described under section titled "2.2 Change authentication method for MySQL root user" in the above guide. You must do this if you want to manage database server using any external programs such as phpMyAdmin.

Once you've setup LAMP stack, enable 'universe' repository, which is disabled by default on Ubuntu 18.04.  To do so, run:

$ sudo add-apt-repository universe

Now is the time to install phpMyAdmin.

To install phpMyAdmin on Ubuntu 18.04, run:

$ sudo apt update
$ sudo apt install phpmyadmin php-mbstring php-gettext

Now, select the web server that should be automatically configured to run phpMyAdmin. Choose the web server with UP/DOWN arrows and hit the SPACEBAR key. Once you chose the web server, you will see a * (star) symbol in-front of it. Hit the TAB key to choose OK and again hit ENTER key to continue.

phpmyadmin 1

Configure phpMyAdmin with Apache web server

Hit ENTER to continue.

phpmyadmin 2

Choose Yes to configure database for phpmyadmin:

phpmyadmin 3

Provide mysql application password phpmyadmin.

phpmyadmin 4

Re-enter password:

phpmyadmin 5

Once phpmyadmin is installed, enable mbstring php extension and restart Apache service o update the changes as shown below.

$ sudo phpenmod mbstring
$ sudo systemctl restart apache2

You can now verify if mbstring extension is enabled or not by loading into info.php file from the web browser.

php mbstring

As you can see in the above screenshot, mbstring module is enabled.

Create dedicated user to access phpMyAdmin dashboard

Once phpMyAdmin is installed, a database user named 'phpmyadmin' will be automatically created with the administrative password you set during the installation. You can login to phpmyAdmin dashboard using 'phpmyadmin' user or mysql root user. However, it is recommended to create a dedicated user to manage databases via phpMyAdmin web interface.

To do so, login to mysql shell using command:

$ mysql -u root -p

Enter your mysql root password. You will now be in mysql shell.

Enter the following command to create a new dedicated user for phpmyadmin:

CREATE USER 'phpmyadminuser'@'localhost' IDENTIFIED BY 'password';

Here, phpmyadmin is the new user for accessing phpmyadmin dashboard. The password for phpmyadminuser is password. Replace these values with your own.

Next give the appropriate privileges to the 'phpmyadminuser' using command:

GRANT ALL PRIVILEGES ON *.* TO 'phpmyadminuser'@'localhost' WITH GRANT OPTION;

Finally exit from mysql shell:

exit
phpmyadmin 6

Create new user for phpmyadmin

We have now created a dedicated user (phpmyadminuser/password) for managing the databases via phpmyadmin web interface. Let us go ahead and access phpmyadmin dashboard.

Access phpMyAdmin dashboard

Open your web browser and navigate to http://ip-address/phpmyadmin or http://domain/phpmyadmin. You should see the phpmyadmin login page. Log in to the phmyadmin interface either using mysql root user or the new user which we created in the previous step.

phpmyadmin 7

Log in to phpMyAdmin interface

Here is how phpMyAdmin dashboard looks:

phpmyadmin 8

PhpMyAdmin dashboard

From now on, you can manage your databases via phpMyAdmin web interface.

Secure phpMyAdmin

Since phpMyAdmin is an easy target for attackers, the next recommended task is to secure phpyMyAdmin. The most common way to protect phpMyAdmin from unauthorized access is by using Apache's built-in .htaccess authentication and authorization functionalities.

First of all, enable the use of .htaccess file overrides by editing the /phpmyadmin.conf file:

$ sudo nano /etc/apache2/conf-available/phpmyadmin.conf

Add "AllowOverride All" line within the <Directory /usr/share/phpmyadmin> section as shown below.

<Directory /usr/share/phpmyadmin>
Options SymLinksIfOwnerMatch
DirectoryIndex index.php
AllowOverride All

[...]

phpmyadmin 9

Save and close the file.

Restart apache service to update the changes using command:

$ sudo systemctl restart apache2

Next, create a file named .htaccess within /usr/share/phpmyadmin/ directory using command:

$ sudo nano /usr/share/phpmyadmin/.htaccess

Add the following lines in it:

AuthType Basic
AuthName "Restricted Files"
AuthUserFile /etc/phpmyadmin/.htpasswd
Require valid-user

Save and close the file.

Now, run the following command to create a new user, for example ostechnix:

$ sudo htpasswd -c /etc/phpmyadmin/.htpasswd ostechnix

Replace 'ostechnix' with any username of your choice. You will asked to provide a password for the new user. Enter it twice.

Sample output:

New password: 
Re-type new password: 
Adding password for user ostechnix

We have now added an extra layer of security to access phpMyAdmin web interface. From now on, whenever you try to access the phpMyAdmin web interface, you will prompted to enter the additional username and its password that you just configured in the previous step.

phpmyadmin 10

Once you entered the correct username and password, you will be redirected to the actual phpmyadmin authentication login page. Just enter your database credentials to access the dashboard.

Resources:

Thanks for stopping by!

Help us to help you:

Have a Good day!!

You May Also Like

30 comments

panca September 26, 2019 - 10:24 am

Thanks

Reply
Michael Mendes November 2, 2019 - 9:07 am

Thank you!

Reply
alamin November 6, 2019 - 5:22 am

I do all thing before section ‘Access phpMyAdmin dashboard’ but phpmyadmin is 404 not found. Please give a solution!

Reply
sk November 6, 2019 - 12:27 pm

That’s odd. Have you already setup LAMP stack? If yes, please try on a fresh system. The instructions given in this guide have been properly tested in Ubuntu 18.04 LTS server and it worked fine for me.

Reply
Arif November 9, 2019 - 9:41 am

http://localhost/phpmyadmin

Not Found
The requested URL was not found on this server.

Reply
Arif November 9, 2019 - 11:09 pm

phpmyadmin.conf file not found, why?

Reply
sk November 10, 2019 - 10:09 pm

Try on a freshly installed system again. The guide is working for me as far as I tested.

Reply
J.F November 16, 2019 - 3:31 am

Hello! Thanks a lot for the tutorial!

I had phpmyadmin is 404 not found problem and solved it doing:

//OPEN apache2.conf FILE WITH TEXT EDITOR
sudo vi /etc/apache2/apache2.conf

// ADD THIS LINE
Include /etc/phpmyadmin/apache.conf

//RESTART apache2
sudo systemctl restart apache2

Cheers.
J.F

Reply
Jelly December 24, 2019 - 9:45 pm

At the stage “Now, select the web server that should be automatically configured to run phpMyAdmin.” I have hit Enter. And when I remove and reinstall the all, I don’t have the new ask for reconfigure PhpMySql.
Help me please !

Reply
AndyN January 17, 2020 - 8:42 pm

sudo nano /etc/apache2/conf-available/phpmyadmin.conf

phpmyadmin.conf is blank and empty new file when you run this command.. is the path diferent/changed

Reply
sk January 18, 2020 - 2:35 pm

The path to phpmyadmin.conf is correct when I tested it in Ubuntu 18.04 server. May be it is changed now. Please check the phpmyadmin official documentation.

Reply
bloon head January 17, 2020 - 11:03 pm

dude thanks please dont change this guide accpet i hate that update change things and this probly wont work in a year so ive done it and duplicated hard disks plus made a copy of all the files needed to do this from scratch and saved this guide … its awesome thanks

Reply
Diaz Alief January 30, 2020 - 11:25 pm

Not Found
The requested URL was not found on this server.

Apache/2.4.29 (Ubuntu) Server at 34.201.36.15 Port 80

Reply
1 2 3

Leave a Comment

* By using this form you agree with the storage and handling of your data by this website.

This site uses Akismet to reduce spam. Learn how your comment data is processed.

This website uses cookies to improve your experience. By using this site, we will assume that you're OK with it. Accept Read More