How to Install and Configure phpMyAdmin on CentOS 6

Updated by Linode

Contribute on GitHub

View Project | View File | Edit File

phpMyAdmin is a web application that provides a GUI to aid in MySQL database administration. It supports multiple MySQL servers and is a robust and easy alternative to using the MySQL command line client.

This guide is written for a non-root user. Commands that require elevated privileges are prefixed with sudo. If you’re not familiar with the sudo command, you can check our Users and Groups guide.

Before You Begin

  1. Ensure that you have followed the Getting Started and Securing Your Server guides and the Linode’s hostname is set.

    To check your hostname run:

    hostname -f

    The first command should show your short hostname, and the second should show your fully qualified domain name (FQDN).

  2. Update your system:

    sudo yum update
  3. Set up a working LAMP stack. Please see the LAMP on CentOS 6 guide if needed.

    If you have installed the php-suhosin package, there are some known issues when using phpMyAdmin. Please visit the Suhosin phpMyAdmin Compatibility Issues page for more information about tuning and workarounds.

  4. Enable the EPEL Repository:

    cd ~
    sudo rpm -ivh epel-release*
  5. Set up Apache with SSL, so your passwords will not be sent over plain text. To do so, go through the SSL Certificates with Apache on CentOS guide.

  6. Install the mycrypt PHP module:

    sudo yum install php-mcrypt
  7. Restart Apache:

    sudo service httpd restart

Installing phpMyAdmin

  1. Install phpMyAdmin:

    sudo yum install phpmyadmin
  2. For each virtual host that you would like to give access to your PHPMyAdmin installation, you must create a symbolic link from the document root to the phpMyAdmin installation location (/usr/share/phpmyadmin):

    cd /var/www/
    sudo ln -s /usr/share/phpmyadmin

    This will create a symbolic link named phpmyadmin in your document root.

Configuring phpMyAdmin

By default, phpMyAdmin is configured to only permit access from the localhost ( You will want to add the IP address of your computer in order to access it.

  1. Make note of the external IP address being used by your home or work computer. This can be found by visiting the following website:

  2. Edit the configuration file located at /etc/httpd/conf.d/phpMyAdmin.conf, replacing the four instances of with the IP address of your home or work computer.

Force SSL

Since you are required to enter your MySQL credentials when using phpMyAdmin, we recommend that you use SSL to secure HTTP traffic to your phpMyAdmin installation. For more information on using SSL with your websites, please consult the guides that address SSL certificates.

  1. Force phpMyAdmin to use SSL in the phpMyAdmin configuration file /etc/phpmyadmin/ by adding the following lines under the Server(s) configuration section:

    $cfg['ForceSSL'] = 'true';
  2. Restart Apache:

    sudo service httpd restart

Testing Your phpMyAdmin Installation

To test phpMyAdmin, open your favorite browser and navigate to You will be prompted for a username and password. Use the username “root” and the password you specified when you installed MySQL. Alternatively, you can log in using any MySQL user and retain their permissions.

If you can successfully log in, phpMyAdmin has been installed properly.

More Information

You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.

This guide is published under a CC BY-ND 4.0 license.