Public | Automated Build

Last pushed: 14 days ago
Short Description
A web interface for MySQL and MariaDB.
Full Description

Official phpMyAdmin Docker image

Run phpMyAdmin with Alpine, supervisor, nginx and PHP FPM.

All following examples will bring you phpMyAdmin on http://localhost:8080
where you can enjoy your happy MySQL administration.


phpMyAdmin does use MySQL server credential, please check the corresponding
server image for information how it is setup.

The official MySQL and MariaDB use following environment variables to define these:

  • MYSQL_ROOT_PASSWORD - This variable is mandatory and specifies the password that will be set for the root superuser account.
  • MYSQL_USER, MYSQL_PASSWORD - These variables are optional, used in conjunction to create a new user and to set that user's password.

Docker hub tags

You can use following tags on Docker hub:

  • latest - latest stable release
  • 4.6 - latest stable release from the 4.6 branch
  • 4.7 - latest stable release from the 4.7 branch
  • edge - bleeding edge docker image (contains stable phpMyAdmin, but the Docker image changes might not yet be fully tested)

Usage with linked server

First you need to run MySQL or MariaDB server in Docker, and this image need
link a running mysql instance container:

docker run --name myadmin -d --link mysql_db_server:db -p 8080:80 phpmyadmin/phpmyadmin

Usage with external server

You can specify MySQL host in the PMA_HOST environment variable. You can also
use PMA_PORT to specify port of the server in case it's not the default one:

docker run --name myadmin -d -e PMA_HOST=dbhost -p 8080:80 phpmyadmin/phpmyadmin

Usage with arbitrary server

You can use arbitrary servers by adding ENV variable PMA_ARBITRARY=1 to the startup command:

docker run --name myadmin -d --link mysql_db_server:db -p 8080:80 -e PMA_ARBITRARY=1 phpmyadmin/phpmyadmin

Usage with docker-compose and arbitrary server

This will run phpMyAdmin with arbitrary server - allowing you to specify MySQL/MariaDB
server on login page.

Using the docker-compose.yml from

docker-compose up -d

Run the E2E tests with docker-compose

You can run the E2E tests with the local test environment by running MariaDB/MySQL databases. Adding ENV variable PHPMYADMIN_RUN_TEST=true already added on docker-compose file. Simply run:

Using the docker-compose.testing.yml from

docker-compose -f docker-compose.testing.yml up phpmyadmin

Adding Custom Configuration

You can add your own custom settings (such as Configuration Storage setup)
by creating a file named "" with the various user defined settings
in it, and then linking it into the container using:

-v /some/local/directory/

On the "docker run" line like this:

docker run --name myadmin -d --link mysql_db_server:db -p 8080:80 -v /some/local/directory/ phpmyadmin/phpmyadmin

See the following links for config file information.

Usage behind reverse proxys

Set the variable PMA_ABSOLUTE_URI to the fully-qualified path ( where the reverse proxy makes phpMyAdmin available.

Environment variables summary

  • PMA_ARBITRARY - when set to 1 connection to the arbitrary server will be allowed
  • PMA_HOST - define address/host name of the MySQL server
  • PMA_VERBOSE - define verbose name of the MySQL server
  • PMA_PORT - define port of the MySQL server
  • PMA_HOSTS - define comma separated list of address/host names of the MySQL servers
  • PMA_VERBOSES - define comma separated list of verbose names of the MySQL servers
  • PMA_USER and PMA_PASSWORD - define username to use for config authentication method
  • PMA_ABSOLUTE_URI - define user-facing URI

For more detailed documentation see

Please report any issues with the Docker container to

Docker Pull Command
Source Repository

Comments (21)
2 months ago

Is there anyway to to make the access URL become http://localhost:8080/phpmyadmin ???
Any plan to support this ?

2 months ago

Hi Guys,

I used to run multiple dockerized MySQL servers on a same host, exposed to the network via port mapping, and access them via a dockerized phpmyadmin, referencing those MySQL servers via the PMA_HOSTS environment variable, as follow:


This was working perfectly with version 4.6.5. However, version 4.6.6 does not seem to like this, at all.

Would you have anything to recommend regarding this use case ?

Many thanks for your help !


2 months ago

Hi Guys,

Can anyone advice how to install the latest version from master? I understand that tags 4.7 or master are not available, right? The :edge is currently 4.6 stable (4.6.6), but how can I install the latest from master?


3 months ago

Is there anyway to to make the access URL become http://localhost:8080/phpmyadmin ???

4 months ago

I cannot go trough PMA login

5 months ago

I cannot go trough PMA login. See here

Thank for any help

6 months ago

I had a lot of struggle with creating custom config - more specific increasing the upload limit. I have changed all required php.ini properties and phpinfo was showing proper results. However I was eternally stuck with 128 Mib on phpmyadmin import screen. I decided to use another unofficial image and I had no issues there.

6 months ago

Can someone confirm that adding custom configuration works? I tried to add a custom file as a volume, using docker-compose, but no changes are applied to PMA


- ./docker-config/pma/

$cfg['ExecTimeLimit'] = 0;
$cfg['MaxNavigationItems'] = 999;
$cfg['MemoryLimit'] = '1280M';



7 months ago


I want to store sessions on my volume. But I cant run docker container with phpmyadmin with sessions in my volume. Where you store sessions? I tried to take them from /var/ /var/lib/php /var/lib/php5 /tmp /etc and so on. But I cant find them on container. Where are they?

7 months ago

Solved. You need to put the internal IP of the docker and root user