The Shopware PaaS Native CLI makes it easy to manage your shops and resources in the cloud.

Prerequisites

Before you start, you'll need a Shopware account. Shopware uses AWS Cognito for identity management. Currently, you must be invited to join our platform before you can access any resources.

Once your organization is onboarded to the Shopware Business Platform (SBP) and users are added to Shopware PaaS Native, the first user gets the admin role. This admin can then assign roles to other users in your organization.

For more on managing users, service accounts, and tokens, see our account guide.

Installation

To install the CLI, run:

curl -L https://install.sw-paas-cli.shopware.systems | sh

The installation script will download the latest version (or specified version) from GitHub releases, install the binary to ~/.sw-paas/bin/sw-paas and add the installation directory to your PATH (if not already present). You can set SW_PAAS_DIR environment variable to customize the installation directory, which defaults to ~/.sw-paas

To install a specific version:

curl -L https://install.sw-paas-cli.shopware.systems | sh -s 0.0.30

INFO

Soon, you'll also be able to install the CLI using popular package managers.

Authentication

After installing, you'll need to log in to use the CLI.

Run the following command to open a browser window and log in to your Shopware PaaS Native account. Your authentication token will be saved automatically.

sw-paas auth

For more details on managing your account, user access, service accounts, and machine tokens for CI/CD, see the account guide.

Authorization

To access resources, you need the right roles in your organization. Only users with the Account Admin role can assign roles to others.

To check your current role:

sw-paas account whoami

If you are an Account Admin and want to add more users, ask the new user to get their user ID:

sw-paas account whoami --output json

Add the user and assign a role:

sw-paas account user add --sub "<user-id of the new user>"

For project-level and application-level access, membership requests, and service accounts, see the account guide.

Available commands

To view all available commands with supported flags:

sw-paas

Need help or found a bug?

If you find a bug or have feedback, please let us know in our issue tracker.