Shopware CLI

Shopware CLI is the open-source command-line interface for working with Shopware 6. It's a standalone developer tool that you install and configure separately from your Shopware instance. Once set up, it helps you automate and speed up common tasks such as:

• managing and configuring Shopware projects
• building, validating, and packaging extensions
• uploading and maintaining extensions in the Shopware Store
• running CI/CD pipelines for Shopware-based solutions

Shopware CLI runs on macOS, Linux, and via Docker. For system-level requirements (PHP, DB, memory, etc.) see the General Requirements.

Supported platforms (short): macOS (Homebrew), Debian/Ubuntu (APT), other Linux via RPM or manual installation, and Docker. Windows users should use WSL 2 or Docker. (See full installation page for Windows details.)

Quickstart

Select your environment to install or try out the CLI:

Binary & releases: Prebuilt packages and archives are published at shopware/shopware-cli · Releases.

Overview

Shopware CLI is organized into three main command scopes that cover the most common development and maintenance workflows:

• Project commands: interact with your Shopware project (e.g., build, dump DB, or sync configuration)
• Extension commands: build and validate Shopware extensions
• Store commands: publish or update extensions in the Shopware Store

Automatic refactoring

Shopware CLI also includes an automatic refactoring tool for PHP, JavaScript, and Admin Twig files. It uses:

• Rector for PHP
• ESLint for JavaScript
• Custom rules for Admin Twig

You can run it on an extension or a full project:

# Example: refactor an extension
shopware-cli extension fix /path/to/your/extension

# Example: refactor an entire project
shopware-cli project fix /path/to/your/project

Always back up or version your code before running refactoring commands, as they will modify files in place. Learn more here.

Project commands

Work directly with your Shopware project to automate setup and maintenance tasks. Available commands include:

shopware-cli project create         # Create a new Shopware 6 project
shopware-cli project dump       # Dumps the Shopware database
shopware-cli project ci          # Build Shopware in the CI

Extension commands

Create, build, and validate Shopware extensions and prepare them for the Store or distribution. Available commands include:

shopware-cli extension fix   # Fix an extension
shopware-cli extension build    # Builds assets for extensions
shopware-cli extension validate         # Validate an extension

Store commands

Publish and manage your extensions in the Store, with commands such as:

shopware-cli store login # Login to Shopware Store portal.
store
shopware-cli token: Manage tokens for Store authentication

Run any command with --help to see its available options. Example: shopware-cli extension --help