> For the complete documentation index, see [llms.txt](https://docs.scaleflex.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scaleflex.com/digital-asset-management-dam/plugins-and-connectors/connectors/commercetools-faas-app.md).

# Commercetools FaaS App

DAM Commercetools connector app

### Installation <a href="#od_ef51fe98" id="od_ef51fe98"></a>

#### Prerequisites <a href="#od_ef51fe98-1" id="od_ef51fe98-1"></a>

* Nginx
* PM2
* Nodejs > v16.10.0
* Certbot

#### Step 1. Download and install <a href="#od_1e92263f" id="od_1e92263f"></a>

To install the DAM module, please follow the steps below:

* 1\.  [Download Latest release of the Module](https://github.com/scaleflex/commercetools-filerobot-plugin/releases)
* 2\. Upload and unzip to the server at your domain path (Ex: /var/www/public\_html/)
* 3\. Configuration Commercetools & DAM plugin **(Read** [**2. Configuration**](#od_ebdb8e0c)**)**
* 4\. Go to the source folder and run "**npm install**", "**npm run build**" (this command will build and create a folder **public**)
* 5\. Go to the folder **public** and run "**pm2 serve --spa**".
* 6\. Config your domain, port you will run with Nginx and create SSL with Certbot [(Read here)](https://tecadmin.net/how-to-generate-lets-encrypt-ssl-using-certbot/) For example, config with port 8080:

<figure><img src="https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252F0Y9bUE0Ws3Vp09Y6ixWt%252Fct1.png%3Falt%3Dmedia%26token%3D56aa5580-e726-4b00-b1f2-a2c88947edcc&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=7ad33493&#x26;sv=1" alt=""><figcaption></figcaption></figure>

#### Step 2. Configure <a href="#od_ebdb8e0c" id="od_ebdb8e0c"></a>

* Get the **applicationId** and **entryPointUriPath** of Commercetools [(Read here)](https://docs.commercetools.com/custom-applications/development/going-to-production#assigning-the-application-id)

![](https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252FzqJ9pfQwApudAMti9bxm%252Fct2.png%3Falt%3Dmedia%26token%3D11ab7bcc-074c-4089-943c-db4f27249525\&width=768\&dpr=4\&quality=100\&sign=203b0cbb\&sv=1)![](https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252FifMNGsmYZRDBe0zgxC9n%252Fct3.png%3Falt%3Dmedia%26token%3D37051dac-7d40-4ae5-8d66-c2278c1d8bf7\&width=768\&dpr=4\&quality=100\&sign=57d18036\&sv=1)![](https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252F3mp1hpXFUsLEC7dmARZg%252Fct4.png%3Falt%3Dmedia%26token%3Df5cc186e-1576-4171-90c5-73af37f27cee\&width=768\&dpr=4\&quality=100\&sign=f32bed10\&sv=1)![](https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252FwRrod7XFb8Qmqfq1s62n%252F1.png%3Falt%3Dmedia%26token%3D6c61916b-2564-4cfd-a3ae-ae5d03cf95f7\&width=768\&dpr=4\&quality=100\&sign=3f28784d\&sv=1)

Configure the DAM module as follow:

<figure><img src="https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252FtyldFSrdskHCq2eW9AuI%252Fct8.png%3Falt%3Dmedia%26token%3Da105f3a3-f8a1-43b5-a500-428f5fddbb83&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=aa2b8798&#x26;sv=1" alt=""><figcaption></figcaption></figure>

* For Commercetools project:
  * Clone file **custom-application-config.example.mjs** and rename to **custom-application-config.mjs**
  * Input your Commercetools configuration
  * Set your **entryPointUriPath** at **src/constants.js**
* For the DAM module:
  * Clone file **filerobot-config.json.example** in folder "**src"** and rename to **filerobot-config.json**
  * Input your DAM token, SEC, upload directory, and any other options as fitting.

### User Guide <a href="#od_ef51fe98-2" id="od_ef51fe98-2"></a>

#### Access Scaleflex DAM <a href="#access-scaleflex-dam" id="access-scaleflex-dam"></a>

In left-menu, select **Scaleflex DAM** > **Products**

<figure><img src="https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252FS7JDhSywZtByHv51RKhg%252F2.png%3Falt%3Dmedia%26token%3D07cf6967-3f31-410d-bd60-b9e6673630dd&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=aedf94a8&#x26;sv=1" alt=""><figcaption></figcaption></figure>

#### Upload/Update Product Images <a href="#upload-update-product-images" id="upload-update-product-images"></a>

In this page select your product variant need to upload/update image

<figure><img src="https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252FBzSismUNUltmji8ALdpw%252F3.png%3Falt%3Dmedia%26token%3Dfb543f81-50f2-4ba9-964f-3af7294fc710&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=d5fcd352&#x26;sv=1" alt=""><figcaption></figcaption></figure>

To add new image, click on "Add Image" in view page Variant Detail

<figure><img src="https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252FBiVPkGd2NL46X5jsmyTD%252F4.png%3Falt%3Dmedia%26token%3Dd9500770-9b90-450e-87b0-8cfdbdca282b&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=b750a60c&#x26;sv=1" alt=""><figcaption></figcaption></figure>

Select an image on the widget and click on "Insert" button to add the image.

**Note:** You can select multiple images.

<figure><img src="https://docs.scaleflex.com/~gitbook/image?url=https%3A%2F%2F3586816136-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fl0Yvbyw1t10jWRzoi0FW%252Fuploads%252F24vMsC1mmqN0EzsKi2Bz%252F5.png%3Falt%3Dmedia%26token%3Dd46307b8-ac2b-4b9c-84a8-b5c8b160a552&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=6f23c54&#x26;sv=1" alt=""><figcaption></figcaption></figure>
