Other Installation Options

If you haven’t already, see the Shopware CLI overview for a quick start and the most common installation methods: Homebrew, APT, and Docker.

This page covers additional options for other package managers, CI/CD environments, or building from source.

Package-manager installs

Shopware CLI is available through several community and distribution channels.

Fedora, CentOS, openSUSE, RHEL (YUM/DNF)

curl -1sLf \
  'https://dl.cloudsmith.io/public/friendsofshopware/stable/setup.rpm.sh' \
  | sudo -E bash
sudo dnf install shopware-cli

Arch Linux (AUR)

yay -S shopware-cli-bin

Nix / NUR packages

nix profile install nixpkgs#shopware-cli
# or latest from FriendsOfShopware
nix profile install github:FriendsOfShopware/nur-packages#shopware-cli

Devenv (Nix-based)

Update devenv.yaml with:

inputs:
  nixpkgs:
    url: github:NixOS/nixpkgs/nixpkgs-unstable
  froshpkgs:
    url: github:FriendsOfShopware/nur-packages
    inputs:
      nixpkgs:
        follows: "nixpkgs"

Then reference the input in devenv.nix:

{ pkgs, inputs, ... }: {
  packages = [
    inputs.froshpkgs.packages.${pkgs.system}.shopware-cli
  ];
}

Manual installation from releases

Download the appropriate .deb, .rpm, or .apk file from the GitHub Releases page and install it manually:

sudo dpkg -i shopware-cli_<version>_linux_amd64.deb   # Debian/Ubuntu
sudo rpm -i shopware-cli_<version>_linux_arm64.rpm    # Fedora/RHEL
sudo apk add shopware-cli-<version>.apk               # Alpine

Alternatively, download the binary and move it into your $PATH:

curl -L -o shopware-cli https://github.com/shopware/shopware-cli/releases/latest/download/shopware-cli-linux-amd64
chmod +x shopware-cli
sudo mv shopware-cli /usr/local/bin/

CI/CD and development environments

These options let you use the CLI automatically in hosted environments. The Shopware CLI overview lists Docker and GitHub Actions, which are popular.

GitHub Codespaces

{
    "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
    "features": {
        "ghcr.io/shyim/devcontainers-features/shopware-cli:latest": {}
    }
}

GitLab CI

build:
  stage: build
  image:
    name: ghcr.io/shopware/shopware-cli:latest
    entrypoint: [ "/bin/sh", "-c" ]
  script:
    - shopware-cli --version

ddev integration

Add a file .ddev/web-build/Dockerfile.shopware-cli

# .ddev/web-build/Dockerfile.shopware-cli
COPY --from=ghcr.io/shopware/shopware-cli:bin /shopware-cli /usr/local/bin/shopware-cli

Docker image

To copy the binary in your Docker image, add the following line:

# Dockerfile
COPY --from=ghcr.io/shopware/shopware-cli:bin /shopware-cli /usr/local/bin/shopware-cli

Add binary manually

Download the pre-compiled binaries from the releases page and copy them to the desired location.

Running with Docker

You can also use it within a Docker container. To do that, you will need to execute something more or less like the examples below.

Registries:

• ghcr.io/shopware/shopware-cli

Example usage: Build assets of an extension

docker run \
    --rm \
    -v $(pwd):$(pwd) \
    -w $(pwd) \
    -u $(id -u) \
    ghcr.io/shopware/shopware-cli \
    extension build FroshPlatformAdminer

Update notifications

Shopware CLI checks in the background for newer releases and prints a short notification to stderr when an update is available. To silence this for a single command, pass --no-update-hint:

shopware-cli --no-update-hint <command>

To disable it for the current shell session (or persistently, by adding it to your shell profile), set:

export SHOPWARE_CLI_NO_UPDATE_NOTIFICATION=true

AI client skill recommendation

When Shopware CLI is invoked by a supported AI coding agent (detected from the AI_AGENT environment variable set by the agent itself) and its shopware-cli skill is not yet installed for that client, the CLI prints a short, non-blocking recommendation to stderr pointing at the shopware-cli ai add command. See AI agent skills for details on the ai command group. It never installs anything automatically and is shown at most once per client every 24 hours.

It stays silent when:

• no AI client is detected
• CI is set
• --no-ai-hint is passed
• the invoked command is itself an ai … command
• the skill is already installed for that client

To silence it for a single command, pass --no-ai-hint:

shopware-cli --no-ai-hint <command>

Environment variables

Authentication and configuration

Variable	Purpose
SHOPWARE_PACKAGES_TOKEN	Composer token for packages.shopware.com, used when the CLI resolves dependencies (for example during project ci)
SHOPWARE_PACKAGIST_TOKEN	Token used by project autofix composer-plugins when it runs headless. Note this is a different variable from SHOPWARE_PACKAGES_TOKEN
COMPOSER_AUTH	Credentials for other private Composer repositories. See the Composer docs
SHOPWARE_CLI_TOOLS_DIR	Point the validation and refactoring tools at a directory you provisioned yourself. When set, the CLI uses it as-is and skips its own tool setup
SHOPWARE_CLI_NO_UPDATE_NOTIFICATION	Set to true to disable update notifications

Both tokens come from your Shopware Account under Shops > Licenses > "..." on any extension > Install via Composer.

Building from source

If you prefer to compile the CLI yourself (requires Go 1.27.0+ and Git):

git clone https://github.com/shopware/shopware-cli
cd shopware-cli

go mod tidy

go build -o shopware-cli .

./shopware-cli --version