# Install the SoftwareOne extension

This topic describes how to install the SoftwareOne extension to connect Alga PSA to the SoftwareOne Marketplace. 

By installing this extension, you can bring data, such as agreements, subscriptions, and orders, directly from SoftwareOne Marketplace into Alga PSA.

### Prerequisites

Before you begin, ensure that you have the following:

* Access to the [Alga PSA MSP Portal](https://algapsa.com/).
* The extension bundle file (`bundle.tar.zst`). You can download this file from [GitHub - SoftwareOne Extension Bundle](https://github.com/softwareone-platform/alga-extension/blob/main/docs/installation/bundle.tar.zst).
* A SoftwareOne Marketplace API token, which you can generate in the [Marketplace Platform](https://portal.platform.softwareone.com/). For details, see [Create API tokens](https://docs.platform.softwareone.com/modules-and-features/settings/api-tokens/create-api-token).

### Installing the SoftwareOne extension

To install the SoftwareOne extension:

1. Sign in to Alga PSA.
2. In the left sidebar, go to **Extensions**.

<div data-with-frame="true"><figure><img src="https://1674205915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ5DNbniz33mXCZoO62Rm%2Fuploads%2F3RMiKSOWhE0NQFk1wUia%2Fimage.png?alt=media&#x26;token=09c90318-41a2-427b-982f-052c72b08ff4" alt="" width="375"><figcaption><p>Navigate to Extensions in Alga PSA.</p></figcaption></figure></div>

3. Select the **Install** tab. In the **Extension Bundle** field, upload the extension bundle file (`bundle.tar.zst`) and select **Install**.

<div data-with-frame="true"><figure><img src="https://1674205915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ5DNbniz33mXCZoO62Rm%2Fuploads%2FIcT9XAcBSFC5jFDbme0a%2Fimage.png?alt=media&#x26;token=b434d324-adcd-44de-bbe8-db66325620d0" alt=""><figcaption><p>Upload and install the extension bundle.</p></figcaption></figure></div>

4. Wait for the installation to complete. Once finished, in the left sidebar, under **Extensions**, verify that **SoftwareOne** is listed.&#x20;

<div data-with-frame="true"><figure><img src="https://1674205915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ5DNbniz33mXCZoO62Rm%2Fuploads%2FBEifL78XoqtvBtklZsp4%2Fimage.png?alt=media&#x26;token=9f42614a-fde7-4cf0-9745-f20a37cdac18" alt=""><figcaption><p>Verify the installed extension.</p></figcaption></figure></div>

5. Select the installed **SoftwareOne** extension, then select **Edit** to configure it. The initial configuration status is displayed as **Unconfigured**.&#x20;

<div data-with-frame="true"><figure><img src="https://1674205915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ5DNbniz33mXCZoO62Rm%2Fuploads%2FEQ0cmMiIBpfdz5fp7DSl%2Fimage.png?alt=media&#x26;token=89feaab8-2e79-4d21-b732-d431d20e09be" alt=""><figcaption><p>Configure the extension settings.</p></figcaption></figure></div>

6. Under **SoftwareOne Settings**, do the following:
   1. Provide the API credentials:
      * **API Endpoint** - `https://api.platform.softwareone.com/public/v1`
      * **API Token** - Paste the token generated in the SoftwareOne Marketplace.
   2. Select **Save** to apply the configuration.

<div align="left" data-with-frame="true"><figure><img src="https://1674205915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ5DNbniz33mXCZoO62Rm%2Fuploads%2FHurKIcMmzgRyANpA0jAo%2Fimage.png?alt=media&#x26;token=cfd57389-628e-403b-814a-baad9f44fdcc" alt=""><figcaption><p>Provide API credentials.</p></figcaption></figure></div>

7. Confirm that the extension is active and its status has changed from **Unconfigured** to **Active**.

<div data-with-frame="true"><figure><img src="https://1674205915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ5DNbniz33mXCZoO62Rm%2Fuploads%2F2WMebNdc909Xq4JGFtQH%2Fimage.png?alt=media&#x26;token=f562c0ed-dc81-4ca8-8419-a660a99d72e8" alt=""><figcaption><p>Confirm that the extension is active.</p></figcaption></figure></div>

### Next steps

Once you have installed and configured the SoftwareOne extension, you can view your account details on the **Settings** tab in Alga PSA, along with your agreements, subscriptions, orders, and statements under their respective tabs.