> For the complete documentation index, see [llms.txt](https://docs.platform.softwareone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.platform.softwareone.com/extensions/alga-psa/install-the-softwareone-extension.md).

# 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](/modules-and-features/settings/api-tokens/create-api-token.md).

### Install 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="/files/uL8RTJeNymQrIQyhARd5" 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="/files/9UrP0n9TUNLtGDCNq3tl" 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="/files/vz9xuytPkfBguEWIgf1a" 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="/files/39sgC4qoDiX8bkJ0iSvx" 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="/files/oO0Gf1Y9dpD4QbgxFa3L" 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="/files/ZDPs7NpSBVoksTBtjdH0" 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.


---

# 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.platform.softwareone.com/extensions/alga-psa/install-the-softwareone-extension.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.