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⁠

⁠Prologue

There are few variants of this adminer image based:

• full (mysql, pgsql, sqlite, mongo)
• mysql (only)
• pgsql (only)
• mongo (only)
• mssql (only)
• oracle-11 / oracle-12 / oracle-19 (only)
• dg (custom)

Features

• 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

By default container is running with these settings, you can override it using environment variables.

• MEMORY=256M (memory_limit)
• UPLOAD=2048M (upload_max_filesize, post_max_size)
• PORT=80 (PHP server listening port)
• WORKERS=4 (concurrency)

docker run \
    --rm
    -p 8000:8080
    -e MEMORY=512M
    -e UPLOAD=4096M
    -e PORT=8080
    dockette/adminer:dg

⁠Versions

⁠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

You can apply a theme by setting the ADMINER_THEME environment variable:

docker run \
    --rm
    -p 8000:80
    -e ADMINER_THEME=dracula
    dockette/adminer:full

If the specified theme is not found, the container will list 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

⁠Upgrade

Upgrade Adminer and Adminer Editor versions to X.Y.Z

ADMINER_VERSION=4.8.1 make update-versions

⁠Maintenance

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