---
title: Shopware Setup | Shopware Community Hub
description: >-
  Learn how to install Shopware locally on macOS and Windows, understand the
  project structure, and take the first steps toward local extension
  development.
canonical_url: 'https://hub.shopware.com/learn/course/shopware-setup'
---

# Shopware Setup

# Shopware Setup

This course shows how to get Shopware running locally for development and how to orient yourself once the project exists.

It connects three things that beginners often need to separate clearly:

- Which local setup path to use on their operating system.
- How the local environment starts and installs Shopware.
- How the Shopware project is structured afterwards.

That way, local installation becomes easier to follow and the first development steps start from a working and understandable setup.

<LearningObjectives>

- Set up Shopware locally on macOS.
- Set up Shopware locally on Windows with WSL2.
- Use Docker as the standard local setup path on macOS and Windows.
- Explain how local tooling, containers, and the Shopware project fit together.
- Navigate the Shopware project structure after setup.
- Take the first steps toward local extension and app development.

</LearningObjectives>

## Learning Units

## Units
- [Shopware Installation on macOS](/learn/unit/shopware-installation-on-macos): Learn how to install Shopware on macOS with Docker by preparing the required tools, creating a project, running the setup, and verifying the local shop.
- [Shopware Installation on Windows](/learn/unit/shopware-installation-on-windows): Learn how to install Shopware on Windows 11 with WSL2, Ubuntu, Docker, and the Docker-based Shopware setup.
- [Setup the Project](/learn/unit/setup-project): This section is a short step-by-step guide on setting up your project and the tools to use.
- [Shopware Platform](/learn/unit/shopware-platform): In this section, we will discover the high-level structure of the Shopware repository.
- [App Development](/learn/unit/app-development): This section provides a practical guide to developing custom Shopware apps, including setup, configuration, and implementation of app features with a…