How to Install Shopware Community Edition on macOS

Shopware is an open-source e-commerce platform that allows businesses to get started with their online stores quickly. In this tutorial, we will guide you through how to install Shopware Community Edition on macOS.

Prerequisites

Before we start, please ensure you have the following installed on your Mac:

  • Homebrew
  • PHP 7.4 and above with the following PHP extensions:
    • curl
    • dom
    • gd
    • iconv
    • intl
    • mbstring
    • pdo_mysql
    • simplexml
    • zip
  • MySQL Server

Step 1 — Installing Composer

Composer is a PHP dependency manager that allows you to install and manage PHP packages.

To install Composer, run the following command in your terminal:

$ brew install composer

Step 2 — Downloading Shopware

Visit the Shopware Community Edition download page and download the latest version of the software.

Once downloaded, place the zip file in your preferred location. For example, inside the /var/www/ directory.

Step 3 — Installing Shopware

Navigate to the directory where you have downloaded and extracted Shopware.

Run the following command to install Shopware.

$ composer install

This installs all the dependencies required by Shopware.

Step 4 — Configuring Shopware

Navigate to the config directory inside Shopware and copy the config.php.dist file to a new file named config.php

$ cp config.php.dist config.php

Edit the config.php file and fill in the required database credentials. 

<?php
// DB Details
$this->db->host = 'localhost';
$this->db->port = '3306';
$this->db->username = 'your_username';
$this->db->password = 'your_password';
$this->db->dbname = 'shopware';

// Shopware URL
$this->appUrl = 'http://localhost/shopware';

Step 5 — Installing Shopware Database

To set up the Shopware database, navigate to the root directory of Shopware and run the following command.

$ ./bin/console database:create

This will create the shopware database.

Next, run the following command to start the Shopware installation.

$ ./bin/console system:install

Follow the installer prompts to complete the installation process.

Step 6 — Starting the Shopware Server

To start the Shopware server, navigate to the root directory of Shopware and run the following command:

$ ./psh.phar storefront:start

This starts the storefront server.

To access your Shopware store, open your web browser and enter the URL http://localhost/shopware

Conclusion

Congratulations! You have successfully installed Shopware Community Edition on macOS. You can now start using Shopware to create your online store.