Install Magento 2.4.3 Community on Docker WSL2

Install and activate Windows WSL2

Follow these instructions to setup your windows for linux subsystem
- https://docs.microsoft.com/en-us/windows/wsl/install-win10

Setup Debian

In windows search and open Microsoft store
Search for Debian App and Install it
Launch the Debian terminal and create a user account
Switch to using the "root" user for the whole installation as this is doesnt cause file permission issues for magento generating files NOTE: Only do this on developer environments!
Change the password for the root user.
```
sudo passwd root
```
Then login under root
```
su root
```
We then need to set root as the default user for Debian.
Close Debian
Open CMD or Powershell and run
```
debian config --default-user root
```
The root user has been set as the primary default user for Debian
Check if you have internet connectivity by running
```
apt update
```
If not see this for more info https://gist.github.com/coltenkrauter/608cfe02319ce60facd76373249b8ca6

Install Docker Desktop

See these instructions for installation
Once installed, Open docker desktop > Settings > General and select "Use the WSL 2 based engine".
Then click on Resources > WSL Integration and select Enable integration with my default WSL distro
Apply and restart Docker desktop
After Docker Desktop has reinitialized, restart windows to be save everything is set properly

Install php7.4 in Debian

Update apt
```
sudo apt update
```
Install wget
```
sudo apt install wget
```

Install dependencies

sudo apt install software-properties-common ca-certificates lsb-release apt-transport-https

Enable SURY repo

sudo sh -c 'echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'

Install gnupg
```
apt-get update
```
```
apt install gnupg
```

Import the GPG key for the repository

wget -qO - https://packages.sury.org/php/apt.gpg | sudo apt-key add -

Install PHP7.4

sudo apt update

sudo apt install php7.4

sudo apt-get install php7.4-{bcmath,curl,xml,fpm,gd,intl,mbstring,mysql,zip,soap}

Check php is installed

php -v

Install composer in Debian

Install curl
```
sudo apt install curl
```

Get composer installer

curl -sS https://getcomposer.org/installer -o composer-setup.php

Get composer key from here and update below Hash variable https://composer.github.io/pubkeys.html

HASH=906a84df04cea2aa72f40b5f787e49f22d4c2f19492ac310e8cba5b96ac8b64115ac402c8cd292b8a03482574915d1a8

Check installer valid

php -r "if (hash_file('SHA384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

Install composer

sudo php composer-setup.php --version=2.1.3 --install-dir=/usr/local/bin --filename=composer

Check installer is installed

composer -v

See WSL files

Open your windows file explorer and put below in your search bar. You will see your Debian installation here
```
\\wsl$
```

Install magento on docker desktop

Referencing these instructions

Get magento community repository using composer

composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition

Get magento auth keys
- Following this link
  - https://devdocs.magento.com/guides/v2.4/install-gde/prereq/connect-auth.html
- Rename auth.json.sample to auth.json and add your public and private keys here
- If asks for authentification required again using cli commands.
  - Public key = username
  - Private key = password
Go to your install directory of magento
```
cd project-community-edition/
```

Install magento ece tools

composer require --no-update --dev magento/ece-tools magento/magento-cloud-docker

Add .magento.docker.yml file to your repository

Check requirements https://devdocs.magento.com/guides/v2.4/install-gde/system-requirements.html

Add below code to .magento.docker.yml file (Make sure this is formatted properly)

name: magento
system:
mode: 'production'
services:
php:
  version: '7.4'
  extensions:
      enabled:
          - xsl
          - json
          - redis
mysql:
  version: '10.4'
  image: 'mariadb'
redis:
  version: '6.0'
  image: 'redis'
elasticsearch:
  version: '7.9'
  image: 'magento/magento-cloud-docker-elasticsearch'
hooks:
build: |
  set -e
  php ./vendor/bin/ece-tools run scenario/build/generate.xml
  php ./vendor/bin/ece-tools run scenario/build/transfer.xml
deploy: 'php ./vendor/bin/ece-tools run scenario/deploy.xml'
post_deploy: 'php ./vendor/bin/ece-tools run scenario/post-deploy.xml'
mounts:
var:
  path: 'var'
app-etc:
  path: 'app/etc'
pub-media:
  path: 'pub/media'
pub-static:
  path: 'pub/static'

Run install script (this may error, just continue installing)

curl -sL https://github.com/magento/magento-cloud-docker/releases/download/1.2.3/init-docker.sh | bash -s -- --php 7.4

If you get this error
```
Unable to find image 'magento/magento-cloud-docker-php:7.4-cli-1.1' locally docker: Error response from daemon: Get "https://registry-1.docker.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers).
```
- Look at these links, this will help
  - https://gist.github.com/coltenkrauter/608cfe02319ce60facd76373249b8ca6#file-fix-wsl2-dns-resolution
  - https://stackoverflow.com/questions/59360629/docker-windows-timeout
    - This was my fix - commented out the registry one seems to work now

Deploy your magento installation (run all at once or remove the && if you want to run one at a time)

composer update &&
docker volume create --name=magento-sync && 
docker volume create --name=mymagento-magento-sync && 
./vendor/bin/ece-docker build:compose --mode="developer" --with-cron --expose-db-port=3306 --no-tls --host=magento2.docker && 
docker-compose up -d && 
docker-compose run --rm deploy php ./vendor/bin/ece-patches apply && 
docker-compose run --rm deploy cloud-deploy  || true && 
docker-compose run --rm deploy cloud-deploy  || true && 
docker-compose run --rm deploy magento-command deploy:mode:set developer && 
docker-compose run --rm deploy cloud-deploy  || true && 
docker-compose run --rm deploy cloud-deploy  || true && 
docker-compose run --rm deploy magento-command deploy:mode:set developer && 
docker-compose run --rm deploy magento-command config:set web/secure/use_in_adminhtml 0 && 
docker-compose run --rm deploy magento-command config:set web/secure/use_in_frontend 0 && 
docker-compose run --rm deploy magento-command config:set web/unsecure/base_url http://magento2.docker/ && 
docker-compose run --rm deploy magento-command config:set web/secure/base_url http://magento2.docker/ && 
docker-compose run --rm deploy cloud-deploy && 
docker-compose run --rm deploy magento-command deploy:mode:set developer

If you have any errors try redeploy few times

docker-compose run --rm deploy cloud-deploy && 
docker-compose run --rm deploy magento-command deploy:mode:set developer && 
docker-compose run --rm deploy magento-command config:set web/secure/use_in_adminhtml 0 && 
docker-compose run --rm deploy magento-command config:set web/secure/use_in_frontend 0 && 
docker-compose run --rm deploy magento-command config:set web/unsecure/base_url http://magento2.docker/ && 
docker-compose run --rm deploy magento-command config:set web/secure/base_url http://magento2.docker/ && 
docker-compose run --rm deploy cloud-deploy && 
docker-compose run --rm deploy magento-command deploy:mode:set developer

If errors on deploy, run cloud-deploy again until it works, this is just initially needs a few deploys

Call to undefined method Magento\Eav\Api\Data\AttributeExtension::setIsPagebuilderEnabled()#0 /app/vendor/magento/framework/Interception/Interceptor.php(146): Magento\
PageBuilder\Plugin\Catalog\Model\Product\Attribute\RepositoryPlugin->afterGet(Object(Magento\Catalog\Model\Product\Attribute\Repository\Interceptor), Object(Magento\Ca
talog\Model\ResourceModel\Eav\Attribute\Interceptor), 'sku')

docker-compose run --rm deploy cloud-deploy

Set your URL to magento instance and https off because its local

docker-compose run --rm deploy magento-command deploy:mode:set developer && 
docker-compose run --rm deploy magento-command config:set web/secure/use_in_adminhtml 0 && 
docker-compose run --rm deploy magento-command config:set web/secure/use_in_frontend 0 && 
docker-compose run --rm deploy magento-command config:set web/unsecure/base_url http://magento2.docker/ && 
docker-compose run --rm deploy magento-command config:set web/secure/base_url http://magento2.docker/ && 
docker-compose run --rm deploy cloud-deploy && 
docker-compose run --rm deploy magento-command deploy:mode:set developer

Set varnish

docker-compose run --rm deploy magento-command config:set system/full_page_cache/caching_application 2 --lock-env && 
docker-compose run --rm deploy magento-command setup:config:set --http-cache-hosts=varnish &&
docker-compose run --rm deploy cloud-deploy && 
docker-compose run --rm deploy cloud-post-deploy && 
docker-compose run --rm deploy magento-command cache:clean

Add localhost ip to your windows host file
- Go to C:\Windows\System32\drivers\etc and open hosts file and add
```
127.0.0.1 magento2.docker
```

Disable vernish as it was loading https

docker-compose run --rm deploy magento-command config:set system/full_page_cache/caching_application 0 --lock-env
docker-compose run --rm deploy cloud-deploy
docker-compose run --rm deploy magento-command cache:flush
docker-compose run --rm deploy magento-command cache:clean

This should load a blank magento luma theme site! http://magento2.docker/

To create an admin user run below, add your variables first.

docker-compose run --rm deploy magento-command admin:user:create --admin-user=<ADD_USER> --admin-password=<ADD_PASSWORD> --admin-email=<ADD_EMAIL>@gmail.com --admin-firstname=Az --admin-lastname=Codez

Credits

Windows Image https://www.pngkit.com/view/u2q8a9o0u2o0y3t4_upgrade-gobierno-open-business-logo-windows-10-home/
Docker image https://mobile.twitter.com/docker
Magento 2 logo https://en.wikipedia.org/wiki/Magento
https://docs.docker.com/
https://devdocs.magento.com/
https://www.adobe.com/
https://www.debian.org/

Feel free to comment questions or feedback✌️

Happy coding,

Az 👨🏾‍💻

Install Magento 2.4.3 Community on Docker WSL2

Comments

More from this blog

Creating database tables and adding data in Magento 2 Adobe Commerce

Automatically Tweet Hashnode blogs using GitHub Actions

Setup GitHub SSH key using Windows

Installing the AWS EB CLI command on Debian 11 (WSL2)

Creating a AWS EC2 using Github Actions and Terraform Cloud

Install and activate Windows WSL2

Setup Debian

Install Docker Desktop

Install php7.4 in Debian

Install composer in Debian

See WSL files

Install magento on docker desktop

Credits

Command Palette

Comments

More from this blog

Install and activate Windows WSL2

Setup Debian

Install Docker Desktop

Install php7.4 in Debian

Install composer in Debian

See WSL files

Install magento on docker desktop

Credits