> For the complete documentation index, see [llms.txt](https://docs.b2b-sellers.com/b2b-platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.b2b-sellers.com/b2b-platform/3/user-guide/setup/install.md).

# Installation

## General notes for your first installation

* Please read the requirements to make sure your shop fulfills them.
* Learn about different types of user accounts that will become available after installation, and the changes made to the "Customer" account if they are marked as B2B customers. [Click here to read the full article](https://docs.b2b-sellers.com/b2b-platform/user-documentation/changes-made-to-customers-what-are-companies-employees-and-sales-representatives).

## Install via composer

{% hint style="info" %}
You will receive the private composer access data by sending a request to <support@b2b-sellers.com>.
{% endhint %}

### I have not set up my access on packagist yet.

1. Open [https://b2bsellers-suite.repo.packagist.com/your-url/](https://b2bsellers-suite.repo.packagist.com/xxxxxxxxxxxxxxx/) and log in with the token you received. Perform the following two steps:
   1. Add the custom repository to the composer.json
   2. Enter your auth-token
2. Now that you're set, continue.

### I already have set up my access on packagist.

1. run "composer require b2b-sellers/core"
2. run in console "`bin/console plugin:refresh &&` bin/console plugin:install -ac b2bsellerscore"
3. Run following commands:\
   &#x20;  bin/console b2b:platform:build\
   &#x20;  bash ./bin/build-storefront.sh\
   &#x20;  bash ./bin/build-administration.sh
4. run `bin/console cache:clear`

## Install via ZIP file

Start by downloading a ZIP file from <https://account.b2b-sellers.app/>

Choose option 1 (extension menu) or option 2 (SSH):

1. via Shopware's extension menu
   1. Go to the admin of your shop and find Extensions.
   2. Upload the ZIP file like any other extension.
   3. After upload, click install.
   4. B2Bsellers Suite is now installed / updated.
2. via SSH
   1. Upload files to custom/plugins/b2bsellerscore
   2. install and activate the Plugin at the Shopware Backend
   3. Or run in console `bin/console plugin:refresh && bin/console plugin:install b2bsellerscore && bin/console plugin:activate b2bsellerscore`&#x20;
   4. switch to console and run command `bin/console b2b:platform:build` at root directory\
      (Normally not necessary if you have received a ZIP file)
   5. run `bin/console cache:clear`

## Use the demo data

\=> Do you want to **install test / demo data** (customers, employees, sales staff and test products)? Then click on the following link

{% content-ref url="/pages/-MVKl3ImnQkiXJeAs2Um" %}
[Use Test-Customers](/b2b-platform/3/user-guide/setup/test-daten.md)
{% endcontent-ref %}

Info: we recommend the install over the cli, not over the shopware backend - sometimes there are errors

first, you have to install the "B2Bsellers Core" Plugin.

### Install-Script for all B2Bsellers Suite Plugins&#x20;

We recommend to use our script to install all B2Bsellers Plugins within one command. You can change all used plugins...

```
#!/bin/bash

echo "Installing all B2bSellers Suite Plugins"

bin/console plugin:refresh
bin/console plugin:install -ac B2bSellersCore

bin/console b2b:platform:build

bash ./bin/build-storefront.sh
bash ./bin/build-administration.sh

exit 0
```

## Important: With every activation/deactivation of the addons the Javascript and the CSS must be built afterwards.

Because all addons are "Symfony bundles", it is necessary to execute the following commands after each addon activation/deactivation:

* bin/console b2b:platform:build
* bash bin/build-administration.sh
* bash bin/build-storefront.sh

## Setup

1. Change the plugin configuration (admin api and store api credentials are needed)
2. Add emails to the following "business events": account\_activation.send and account\_request.send

## Api

Flag for sending welcome mail via api (customer create + update) -> \_sendWelcomeMail

## Console commands

#### 5.1 Entity Mapping Command (CustomerPrices):

**Usage:**

`bin/console b2b:entity:map`

#### 5.2 Platform watch command

**Usage:**

`bin/console b2b:platform:watch <user>`&#x20;

**Arguments:**

| Argument     | Description                |
| ------------ | -------------------------- |
| **user**     | Customer/Employee E-Mail   |
| **password** | Customer/Employee password |

**Example:**

Sales Agent: `bin/console b2b:platform:watch m.sommer@luxon.de`&#x20;

Customer-Employee `bin/console b2b:platform:watch Henk.Becker@ektek.com b2bsellers`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.b2b-sellers.com/b2b-platform/3/user-guide/setup/install.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.