# Setup ## New Magento 2 Project (macOS/Linux) 1. Create the project template by going to the place you want the new project (ex. cd ~/Sites/magento2), then run - `curl -s https://raw.githubusercontent.com/markshust/docker-magento/master/lib/template | bash` 2. Extract the contents of your current Magento site to the `src` folder, or download a fresh copy of the Magento source code for starting a new project with: - `bin/download 2.3.0` 3. Add an entry to your local hosts file with your custom domain. Assuming the domain you want to setup is `magento2.test`, enter the below. Be sure to use a `.test` tld, as `.localhost` and `.dev` will present issues with domain resolution. - `echo "127.0.0.1 magento2.test" | sudo tee -a /etc/hosts` 4. Start your Docker containers with the provided helper script: - `bin/start` 5. For new projects: run Magento's setup install process with the below helper script. Feel free to edit this file to your liking; at the very least you will probably need to update the `base-url` value to the domain you setup in step 3. Also, be sure to setup [Composer Authentication](https://github.com/markshust/docker-magento#composer-authentication) before initiating the setup script. - `bin/setup magento2.test` 6. You may now access your site! Check out whatever domain you setup from within a web browser. - `open http://magento2.test` ## New Magento 2 Project (Windows) Works with Docker in WSL. Full instructions to follow.