Install Magento 2.4.3 Community on Docker WSL2

Install Magento 2.4.3 Community on Docker WSL2

Instructions on how I setup Magento 2 / Adobe commerce on Windows

Asrin Dayananda
·Nov 29, 2021·

6 min read

Subscribe to my newsletter and never miss my upcoming articles

Listen to this article

Table of contents

  • 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

Install and activate Windows WSL2

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 gist.github.com/coltenkrauter/608cfe02319ce..

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 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
    • 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 devdocs.magento.com/guides/v2.4/install-gde..
    • 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).
      
  • 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! 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

Feel free to comment questions or feedback✌️

Happy coding,

Az 👨🏾‍💻

Did you find this article valuable?

Support Asrin Dayananda by becoming a sponsor. Any amount is appreciated!

See recent sponsors Learn more about Hashnode Sponsors
 
Share this