mirror of
https://github.com/phpmyadmin/docker.git
synced 2026-09-24 23:49:37 -05:00
Michal Čihař
a5dfdfe993
- move it to root directory to make it easier to use as volume Signed-off-by: Michal Čihař <michal@cihar.com>
82 lines
2.9 KiB
Markdown
82 lines
2.9 KiB
Markdown
# Official phpMyAdmin Docker image
|
|
|
|
Run phpMyAdmin with Alpine and PHP built in web server.
|
|
|
|
[](https://travis-ci.org/phpmyadmin/docker)
|
|
[][hub]
|
|
[][hub]
|
|
|
|
|
|
All following examples will bring you phpMyAdmin on `http://localhost:8080`
|
|
where you can enjoy your happy MySQL administration.
|
|
|
|
|
|
## 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 https://github.com/phpmyadmin/docker
|
|
|
|
```
|
|
docker-compose up -d
|
|
```
|
|
|
|
## Adding Custom Configuration
|
|
|
|
You can add your own custom config.inc.php settings (such as Configuration Storage setup)
|
|
by creating a file named "config.user.inc.php" with the various user defined settings
|
|
in it, and then linking it into the container using:
|
|
|
|
```
|
|
-v /some/local/directory/config.user.inc.php:/config.user.inc.php
|
|
```
|
|
On the "docker run" line like this:
|
|
```
|
|
docker run --name myadmin -d --link mysql_db_server:db -p 8080:80 -v /some/local/directory/config.user.inc.php:/config.user.inc.php phpmyadmin/phpmyadmin
|
|
```
|
|
|
|
See the following links for config file information.
|
|
http://docs.phpmyadmin.net/en/latest/config.html#config
|
|
http://docs.phpmyadmin.net/en/latest/setup.html
|
|
|
|
## 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_PORT`` - define port of the MySQL server
|
|
* ``PMA_HOSTS`` - define comma separated list of address/host names of the MySQL servers
|
|
* ``PMA_USER`` and ``PMA_PASSWORD`` - define username to use for config authentication method
|
|
* ``PHP_UPLOAD_MAX_FILESIZE`` - define upload_max_filesize and post_max_size PHP settings
|
|
* ``PHP_MAX_INPUT_VARS`` - define max_input_vars PHP setting
|
|
|
|
For more detailed documentation see https://docs.phpmyadmin.net/en/latest/setup.html#installing-using-docker
|
|
|
|
[hub]: https://hub.docker.com/r/phpmyadmin/phpmyadmin/
|