From b039fa3305be85da8af5a497c1f920c26e7c1553 Mon Sep 17 00:00:00 2001 From: Aaron Feledy Date: Sun, 22 Feb 2026 14:41:20 -0600 Subject: [PATCH 1/3] fix: switch to official phpmyadmin Docker image for arm64 support --- CHANGELOG.md | 1 + builders/phpmyadmin.js | 2 +- docs/config.md | 2 +- docs/index.md | 14 +++++++------- 4 files changed, 10 insertions(+), 9 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 226b340..3028e55 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,6 @@ ## {{ UNRELEASED_VERSION }} - [{{ UNRELEASED_DATE }}]({{ UNRELEASED_LINK }}) +* Switched to official `phpmyadmin` Docker image for arm64/Apple Silicon support [#61](https://github.com/lando/phpmyadmin/issues/61) * Updated `vite` from 5.4.20 to 5.4.21 * Updated `mdast-util-to-hast` from 13.2.0 to 13.2.1 * Updated `lodash-es` from 4.17.21 to 4.17.23 diff --git a/builders/phpmyadmin.js b/builders/phpmyadmin.js index 5a035f4..8bbcd5e 100644 --- a/builders/phpmyadmin.js +++ b/builders/phpmyadmin.js @@ -34,7 +34,7 @@ module.exports = { // Assemble the service config const pmaService = { - image: `phpmyadmin/phpmyadmin:${options.version}`, + image: `phpmyadmin:${options.version}`, environment: { MYSQL_ROOT_PASSWORD: '', PMA_HOSTS: options.hosts.join(','), diff --git a/docs/config.md b/docs/config.md index 92b5737..1ec5c8a 100644 --- a/docs/config.md +++ b/docs/config.md @@ -70,7 +70,7 @@ services: ## Advanced -There are also [several various envvars](https://hub.docker.com/r/phpmyadmin/phpmyadmin/) exposed by the underlying image we use that you can set to further customize how your PhpMyAdmin works. **These are not officially supported** so we *highly recommend* you do not alter them unless you know what you are doing. Even then, YMMV. +There are also [several various envvars](https://hub.docker.com/_/phpmyadmin) exposed by the underlying image we use that you can set to further customize how your PhpMyAdmin works. **These are not officially supported** so we *highly recommend* you do not alter them unless you know what you are doing. Even then, YMMV. That said, you will need to use a [service override](https://docs.lando.dev/services/lando-3.html#overrides) to take advantage of them as shown below: diff --git a/docs/index.md b/docs/index.md index 50877fe..39879da 100644 --- a/docs/index.md +++ b/docs/index.md @@ -18,17 +18,17 @@ services: ## Supported versions -* [5.2](https://hub.docker.com/r/phpmyadmin/phpmyadmin/) -* [5.1](https://hub.docker.com/r/phpmyadmin/phpmyadmin/) -* [5.0](https://hub.docker.com/r/phpmyadmin/phpmyadmin/) +* [5.2](https://hub.docker.com/_/phpmyadmin) +* [5.1](https://hub.docker.com/_/phpmyadmin) +* [5.0](https://hub.docker.com/_/phpmyadmin) * [custom](https://docs.lando.dev/services/lando-3.html#overrides) ## Legacy versions -* [4.9](https://hub.docker.com/r/phpmyadmin/phpmyadmin/) -* [4.8](https://hub.docker.com/r/phpmyadmin/phpmyadmin/) -* [4.7](https://hub.docker.com/r/phpmyadmin/phpmyadmin/) -* [4.6](https://hub.docker.com/r/phpmyadmin/phpmyadmin/) +* [4.9](https://hub.docker.com/_/phpmyadmin) +* [4.8](https://hub.docker.com/_/phpmyadmin) +* [4.7](https://hub.docker.com/_/phpmyadmin) +* [4.6](https://hub.docker.com/_/phpmyadmin) ## Patch versions From 1d79e0894f8ebd70436c6906c3de98e76ea3f0ff Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 22 Feb 2026 20:47:00 +0000 Subject: [PATCH 2/3] Fix: Use phpmyadmin/phpmyadmin image for legacy 4.x versions The official phpmyadmin Docker image only has 5.x tags. Legacy 4.x versions (4.9, 4.8, 4.7, 4.6) are only available on the deprecated phpmyadmin/phpmyadmin image. This change uses the appropriate image based on version to prevent Docker pull failures for legacy versions. Applied via @cursor push command --- builders/phpmyadmin.js | 2 +- docs/index.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/builders/phpmyadmin.js b/builders/phpmyadmin.js index 8bbcd5e..f1c196e 100644 --- a/builders/phpmyadmin.js +++ b/builders/phpmyadmin.js @@ -34,7 +34,7 @@ module.exports = { // Assemble the service config const pmaService = { - image: `phpmyadmin:${options.version}`, + image: semver.lt(`${options.version}.0`, '5.0.0') ? `phpmyadmin/phpmyadmin:${options.version}` : `phpmyadmin:${options.version}`, environment: { MYSQL_ROOT_PASSWORD: '', PMA_HOSTS: options.hosts.join(','), diff --git a/docs/index.md b/docs/index.md index 39879da..d4b884f 100644 --- a/docs/index.md +++ b/docs/index.md @@ -25,10 +25,10 @@ services: ## Legacy versions -* [4.9](https://hub.docker.com/_/phpmyadmin) -* [4.8](https://hub.docker.com/_/phpmyadmin) -* [4.7](https://hub.docker.com/_/phpmyadmin) -* [4.6](https://hub.docker.com/_/phpmyadmin) +* [4.9](https://hub.docker.com/r/phpmyadmin/phpmyadmin) +* [4.8](https://hub.docker.com/r/phpmyadmin/phpmyadmin) +* [4.7](https://hub.docker.com/r/phpmyadmin/phpmyadmin) +* [4.6](https://hub.docker.com/r/phpmyadmin/phpmyadmin) ## Patch versions From b36bfbd2dc28c78870e151da4b14e773360df7b9 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sun, 22 Feb 2026 20:52:50 +0000 Subject: [PATCH 3/3] Fix phpMyAdmin version threshold to support 5.0/5.1 tags Change version threshold from 5.0.0 to 5.2.0 to ensure versions 5.0 and 5.1 use the deprecated phpmyadmin/phpmyadmin image where these tags exist, since the official phpmyadmin image only supports 5.2.x and higher. --- builders/phpmyadmin.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/builders/phpmyadmin.js b/builders/phpmyadmin.js index f1c196e..2c07d01 100644 --- a/builders/phpmyadmin.js +++ b/builders/phpmyadmin.js @@ -30,11 +30,11 @@ module.exports = { // Arrayify the hosts if needed if (!_.isArray(options.hosts)) options.hosts = [options.hosts]; // Switch to legacy command if needed - if (semver.lt(`${options.version}.0`, '5.0.0')) options.command = '/run.sh phpmyadmin'; + if (semver.lt(`${options.version}.0`, '5.2.0')) options.command = '/run.sh phpmyadmin'; // Assemble the service config const pmaService = { - image: semver.lt(`${options.version}.0`, '5.0.0') ? `phpmyadmin/phpmyadmin:${options.version}` : `phpmyadmin:${options.version}`, + image: semver.lt(`${options.version}.0`, '5.2.0') ? `phpmyadmin/phpmyadmin:${options.version}` : `phpmyadmin:${options.version}`, environment: { MYSQL_ROOT_PASSWORD: '', PMA_HOSTS: options.hosts.join(','),