v3.3.0

3.3.0 (2026-05-31)

Features

• automatically composer install and setup:install if possible (#30) (fc67f1d)

v3.2.0

3.2.0 (2026-05-31)

Features

• add workspace service port-forwarding to work around codespaces (2c8d28b)
• ensure that .gitignored files are correctly gitignored (95cb7d6)
• port-forward 8000 and 8025 on the workspace container on startup (da74bfa)
• skip install if app/etc/env.php exists (a80cd97)

v3.1.0

3.1.0 (2026-05-27)

Features

• run setup-install with no-interaction (8b5b7b3)

v3.0.0

3.0.0 (2026-05-25)

⚠ BREAKING CHANGES

• Compose directories moved

Vanilla Magento compose stacks now live at compose/magento/<version>/, not compose/<version>/. Existing projects must update the dockerComposeFile entry in .devcontainer/devcontainer.json:

-    "magento2-devcontainer/compose/2.4.9/docker-compose.yml",
+    "magento2-devcontainer/compose/magento/2.4.9/docker-compose.yml",

Easiest migration: re-run bin/init.sh and let it regenerate devcontainer.json against the new layout.

• jq is now a runtime dependency

Required by bin/init.sh and bin/setup-install.sh for parsing composer.json / composer.lock. Install on the host:

apt install jq        # Debian/Ubuntu
brew install jq       # macOS

Features

• add out-of-the-box support for Magento v2.4.9 (#25) (d86e5ab)
• add wait for services check just to make sure everything is up (e86e642)
• determine codespaces url from environment configuration (a9d3e0f)
• embed CONFIG__DEFAULT__WEB__URL__REDIRECT_TO_BASE to make codespaces work (fe54779)
• enable auto port-forward from codespaces (375c2dd)
• honor X-Forwarded-Host/Proto for FastCGI (3193f39)
• relabel nginx port name (7fd7ea2)
• remove extranous ports (c2fffbf)
• replace waits with healthchecks (c3adb3b)
• support mage-os and mage-os-minimal distributions (#26) (803523a)
• use discovered MAGENTO_ROOT to set commands for setup:install (244a4d6)

Bug Fixes

• disable redirect_to_base behavior (5133c68)
• disable USE_SECURE in local devcontainer (bb114fc)
• remove extraneous codespaces-portforward.sh (e976df9)
• restore unnamed port prefixes (dbacff2)
• swap from mysqladmin to healthcheck.sh for mariadb:11.4 (877e326)

v2.0.0

2.0.0 (2026-04-07)

⚠ BREAKING CHANGES

• Unfortunately, on Macs and Linux boxes, VSCode will often fail to port-forward 443 and 80. Sometimes, these will work and cause VSCode to request privileges, but more often than not, they don't. It's easier to just use a non-privileged port than fight against admin access. As such, you can now access your site on the portforward 8000 and 8443 instead.

Features

• support mailpit for local email (#10) (ed79770)
• use non-privileged ports for nginx (e452bc7)

Bug Fixes

• adjust base_url after breakage from e452bc7 (56cf07b)

v1.1.0

1.1.0 (2026-02-17)

Features

• add speedscope feature (29a0674)
• allow docker-in-docker to shell to other containers (93284bc)

v1.0.0

1.0.0 (2026-02-05)

⚠ BREAKING CHANGES

• remove bin/db/import.sh in favor of n98-magerun2 db:import

Features

• add a db import script (cfb7f8f)
• add a sample .env (075282b)
• add claude code system req (f9abca8)
• add claude to devcontainer (880adf3)
• add configurations for local TLS (87835cb)
• add system requirements for devcontainer (3eb7121)
• allow devcontainer discovery more than one folder deep (d3d78a3)
• change filesystem permissions during setup:install (2072680)
• hoist all branches into the main branch (5f63792)
• improve devx of initing the devcontainer (8530e34)
• improve naming conventions for docker-compose (837dcc3)
• init devcontainer (6b7489d)
• init.sh compute available versions from static list (fef07b7)
• install node using Corepack instead of Yarn APT to avoid GPG errors (#2) (4aa9871)
• make friendly-name versions of the yml (65dee91)
• remove bin/db/import.sh in favor of n98-magerun2 db:import (3729204)
• remove latest/next versions that don't work (177c553)
• upgrade 2.4.8 deps from system requirements (7168cba)
• upgrade 2.4.8 deps from system requirements (7ac61fe)
• use opensearch via CONFIG (8bc590a)
• v2.4.6 - mysql:8.0, disable tls and enable log-bin-trust-function-creators (1e62285)

Bug Fixes

• adjust bad paths in dockerComposeFile (342b677)
• adjust bad paths in dockerComposeFile (0611158)
• remove bad workspaceFolder path in sample devcontainer (ee649af)
• use appropriate mariadb version for 2.4.7 (5ebef36)