dockette/adminer repository overview

⁠Dockette / Adminer

🎁 Tiniest boxed dockerized Adminer (MySQL, PostgreSQL, SQLite, Mongo, Oracle, MSSQL) Dockerfiles. Database management in a single PHP file.

🕹 f3l1x.io⁠ | 💻 f3l1x⁠ | 🐦 @xf3l1x⁠

Adminer⁠ is a database management tool in a single PHP file. These are the tiniest boxed Dockerfiles for it: one image per database family (MySQL, PostgreSQL, SQLite, Mongo, Oracle, MSSQL).

⁠Features

• Variants: full (mysql, pgsql, sqlite, mongo), mysql, pgsql, mongo, mssql, oracle-11 / oracle-12 / oracle-19 (each only), dg (custom)
• Alpine Linux (full, editor, dg, mongo, mysql, postgres)
• Debian Bookworm (mssql, oracle-11, oracle-12, oracle-19)
• PHP 8 (concurrency via PHP cli workers)

⁠Usage

docker run --rm -p 8000:80 dockette/adminer:dg

# Override the defaults with environment variables
docker run --rm -p 8000:8080 -e MEMORY=512M -e UPLOAD=4096M -e PORT=8080 dockette/adminer:dg

# Apply a theme
docker run --rm -p 8000:80 -e ADMINER_THEME=dracula dockette/adminer:full

⁠Configuration

The container runs with these settings by default. Override them with environment variables.

• MEMORY=256M (memory_limit)
• UPLOAD=2048M (upload_max_filesize, post_max_size)
• PORT=80 (PHP server listening port)
• WORKERS=4 (concurrency)
• ADMINER_THEME (theme name, see Themes⁠; an unknown name lists all available themes)

⁠Images

⁠dockette/adminer:mssql

Debian-based image with Microsoft ODBC Driver 18 and PHP sqlsrv / pdo_sqlsrv extensions.

docker run \
    --rm \
    -p 8080:80 \
    dockette/adminer:mssql

By default, TrustServerCertificate is set to yes so the image works out of the box with self-signed certificates (common in development). You can control encryption behavior via environment variables:

⁠dockette/adminer:dg

You should take a look to the official github profile (https://github.com/dg/adminer-custom⁠).

⁠Plugins

Adminer plugins can be enabled via environment variables. All plugins are disabled by default. Available for all image variants except dg.

⁠Autologin

Skips the login form and connects directly to a database server.

DSN format: driver://username:password@host:port/database

docker run \
    --rm \
    -p 8080:80 \
    -e ADMINER_PLUGIN_AUTOLOGIN=1 \
    -e ADMINER_AUTOLOGIN_SERVER=server://root:secret@mysql:3306/mydb \
    dockette/adminer:full

Supported drivers: server (MySQL/MariaDB), pgsql, sqlite, mongo, oracle, elastic.

⁠Server List

Displays a dropdown of pre-configured database servers with an Auto Sign-In button. Credentials are handled server-side and never exposed to the browser.

docker run \
    --rm \
    -p 8080:80 \
    -e ADMINER_PLUGIN_SERVER_LIST=1 \
    -e ADMINER_SERVERS_MySQL=server://root:secret@mysql:3306/mydb \
    -e ADMINER_SERVERS_PostgreSQL=pgsql://postgres:pwd@pg:5432/app \
    -e ADMINER_SERVERS_DevDB=server://dev@devhost:3306 \
    dockette/adminer:full

Servers without credentials in the DSN (e.g. server://devhost:3306) appear in the dropdown but require manual login. The Auto Sign-In button only appears for servers with stored credentials.

⁠Themes

Set the ADMINER_THEME environment variable to apply a theme, see Usage⁠. If the specified theme is not found, the container lists all available themes.

⁠Available Themes

default	adminer-dark	brade	bueltge	dracula
esterka	flat	galkaev	haeckel	hever
konya	lavender-light	lucas-sandery	mancave	mvt
nette	ng9	nicu	pappu687	paranoiq
pepa-linha	pokorny	price	rmsoft	rmsoft_blue
rmsoft_blue-dark	win98

⁠Versions

All versions build on Adminer 6.1.1, pinned by ADMINER_VERSION in VERSION. Releases are listed on GitHub⁠.

⁠Development

make build                                     # build all images
make build-<variant>                           # build one image, e.g. build-mysql
make test                                      # run php --version in all images
make run                                       # run the full image on port 8000
make update-versions ADMINER_VERSION=X.Y.Z     # set the Adminer (and Editor) version in VERSION and the Dockerfiles
make version                                   # print VERSION
make release                                   # set today's date in VERSION

⁠Maintenance

See how to contribute⁠ to this package. Consider to support⁠ f3l1x. Thank you for using this package.