updated template for gui db

2026-09-03 18:36:22 +00:00 · 2026-07-14 23:19:54 -07:00
parent b892335522
commit 33464204d4
8 changed files with 180 additions and 45 deletions
@@ -1,10 +1,65 @@
-# phpmyadmin
-
-Last Updated: Mon September 02, 2024 23:27:25 PDT
+# phpMyAdmin

 ## Overview

-Docker Hub: https://hub.docker.com/r/phpmyadmin/phpmyadmin/tags
-Proxy Port: 80
+phpMyAdmin is a web-based MySQL/MariaDB database administration tool. This stack runs phpMyAdmin with arbitrary server connection support.

-Not for production, there is no password protection by default.
+## Project Details
+
+-   **Project Repository:** [https://github.com/phpmyadmin/phpmyadmin](https://github.com/phpmyadmin/phpmyadmin)
+-   **Container Image:** [Docker Hub](https://hub.docker.com/r/phpmyadmin/phpmyadmin)
+-   **Documentation:** [https://www.phpmyadmin.net/docs/](https://www.phpmyadmin.net/docs/)
+-   **Reverse Proxy Port:** `80`
+
+## Getting Started
+
+1. Start the container: `docker compose up -d`
+2. Open http://localhost:${PHPMYADMIN_PORT:-8083} in your browser
+3. Log in with your database credentials
+
+## Environment Variable Notes
+
+    PHPMYADMIN_PMA_ARBITRARY – allow connecting to any database server (default: 1)
+    PHPMYADMIN_PMA_HOST – default database host (default: mariadb)
+    PHPMYADMIN_PMA_USER – default database user (default: root)
+    PHPMYADMIN_PMA_PASSWORD – default database password (default: changeme)
+    PHPMYADMIN_UPLOAD_LIMIT – maximum upload size (default: 200M)
+
+## Volume Notes
+
+No persistent volumes required.
+
+## Network Notes
+
+Requires the external `proxy` network (Nginx Proxy Manager). An internal bridge network `internal` is available for connecting to database containers.
+
+## Docker Run
+
+```bash
+docker run -d \
+  --name phpmyadmin \
+  -e PMA_ARBITRARY=1 \
+  -e PMA_HOST=mariadb \
+  -e PMA_USER=root \
+  -e PMA_PASSWORD=changeme \
+  -e UPLOAD_LIMIT=200M \
+  -p 8083:80 \
+  --network proxy \
+  phpmyadmin/phpmyadmin:latest
+```
+
+## Additional Notes / Gotchas
+
+- Not for production use — there is no built-in authentication layer beyond the database credentials.
+- Set `PMA_ARBITRARY=1` to connect to any database server by hostname at login time.
+
+## Dockhand Stack, Deploy from Git
+
+Cookbooks Repository
+stackname: PHPMYADMIN_DEV
+Compose file path: phpmyadmin_dev/compose.yaml
+Additional env file (optional): phpmyadmin_dev/sample.env
+
+Then "Load" phpmyadmin_dev/sample.env into the Environmental variables in dockhand
+
+Create the Stack