Magento 2 DevContainer

This devcontainer provides a complete development environment for Magento 2 that meets Adobe's official system requirements.

Prerequisites

• VSCode (or an editor that supports devcontainers)
• Docker
• Github Codespaces (Optional)

Installed tools

Devcontainer Features (You control)

• Claude Code
• Github CLI

Container built-ins

• n98-magerun2
• composer
• Xdebug

Supported Versions

This environment will support all of the currently supported Magento versions. There are multiple configurations available (one for each major version of Magento).

Magento Version	Configuration
v2.4.6	compose/2.4.6/docker-compose.yml
v2.4.7	compose/2.4.7/docker-compose.yml
v2.4.8	compose/2.4.8/docker-compose.yml
v2.4.9	compose/2.4.9/docker-compose.yml

Getting Started

1. Make a .devcontainer folder in your project

mkdir -p .devcontainer

2. Add this repository as a git submodule to your Magento project:

git submodule add https://github.com/graycoreio/magento2-devcontainer.git .devcontainer/magento2-devcontainer

3. Run the init script

/bin/bash .devcontainer/magento2-devcontainer/bin/init.sh

[!INFO] If you're on Windows (and not using WSL2) and don't have access to bash, you can simply get away with copying the sample devcontainer.json.sample, docker-compose.overrides.yml and making a simple docker-compose.yml with the following content into your .devcontainer folder:

services: {}

4. Open the project in VS Code and click "Reopen in Container" when prompted.

5. (Optional) Run the setup script

/bin/bash .devcontainer/magento2-devcontainer/bin/setup-install.sh

Additional Resources

• Magento 2 DevDocs
• Magento Release Notes
• System Requirements