Skip to content


You can install the pre-compiled binary (in several different ways), use Docker or compile from source.

Below you can find the steps for each of them.

Install the pre-compiled binary


brew install FriendsOfShopware/tap/shopware-cli

Debian/Ubuntu — APT based Linux

curl -1sLf \
  '' \
  | sudo -E bash
sudo apt install shopware-cli

Fedora/CentOS/SUSE/RedHat — YUM based Linux

curl -1sLf \
  '' \
  | sudo -E bash
sudo dnf install shopware-cli

Alpine — APK based Linux

sudo apk add --no-cache bash
curl -1sLf \
  '' \
  | sudo -E bash
sudo apk add --no-cache shopware-cli

Archlinux User Repository (AUR)

yay -S shopware-cli-bin

Manually: deb,rpm apt packages

Download the .deb, .rpm or .apk packages from the releases page and install them with the appropriate tools.


nix-env -iA nixpkgs.shopware-cli


{ pkgs, ... }: {
  packages = [ pkgs.shopware-cli ];

GitHub Codespaces

    "image": "",
    "features": {
        "": {}

GitHub Action

using Shopware CLI Action

- name: Install shopware-cli
  uses: FriendsOfShopware/shopware-cli-action@v1
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

go install

go install


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

# .ddev/.web-build/Dockerfile.shopware-cli
RUN curl -1sLf '' | sudo -E bash \
  && apt install shopware-cli


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'll need to execute something more-or-less like the examples below.


Example usage:

Builds assets of an extension

docker run \
    --rm \
    -v $(pwd):$(pwd) \
    -w $(pwd) \
    -u $(id -u) \ \
    extension build FroshPlatformAdminer

You can verify the image with cosign:

cosign verify \
  --certificate-identity '' \
  --certificate-oidc-issuer ''

Hint: You have to adjust the version inside the certificate-identity

Compiling from source

If you just want to build from source for whatever reason, follow these steps:


git clone
cd shopware-cli

get the dependencies:

go mod tidy


go build -o shopware-cli .

verify it works:

./shopware-cli --version