Using with an Existing Magento Project

If you already have a Magento project with a composer.json, follow these steps to add the devcontainer.

Prerequisites

• VS Code with the Dev Containers extension
• Docker

Steps

1. Add the devcontainer as a submodule:

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

2. Run the init script:

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

The script auto-detects your Magento version from composer.json and generates the devcontainer configuration.

3. Open in VS Code and click Reopen in Container when prompted.

4. Install dependencies and run setup:

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

5. Verify the installation:

bin/magento --version

Next Steps

• Docker Compose Configuration - Customize your environment
• TLS Setup - Enable HTTPS for local development