# Configure Single Sign-On (SSO)

{% hint style="danger" %}
**This documentation is for the CARTO Self-Hosted Legacy Version**. Use only if you've installed this specific version. Explore our latest documentation for updated features.
{% endhint %}

This guide outlines the steps to configure Single Sign-On (SSO) for your CARTO Self-Hosted instance. [SSO integration](https://docs.carto.com/carto-user-manual/settings/sso) enhances security and user experience by allowing users to log in with a single set of credentials across multiple systems.

## Prerequisites

{% hint style="info" %}
Please get in touch at <support@carto.com> to start configuring your SSO integration.
{% endhint %}

1. **Contact CARTO Support:**
   * Initiate contact with the CARTO Support team to request assistance with SSO configuration.
   * Work closely with the Support team to communicate your organization's specific requirements.
2. **Obtain organization ID:**
   * Once SSO is successfully configured from the CARTO side, CARTO Support team will provide you with a unique identifier known as the organization ID. This organization ID is **required to continue with the SSO configuration** in your CARTO Self-Hosted installation.

## Single VM deployments (Docker Compose)

To integrate the obtained Organization ID with your CARTO Self-Hosted instance, you just have to add a new environment variable into your <mark style="color:orange;">customer.env</mark> file:

```
REACT_APP_ORGANIZATION_ID="<YOUR_ORGANIZATION_ID>"
```

Once you've added this new environment variable, you'll have to execute the installation script and restart your CARTO deployment so that the new changes are applied.

## Conclusion

With the successful integration of SSO and the Organization ID, your CARTO Self-Hosted instance is now configured to provide a seamless and secure Single Sign-On experience for your users. You can now navigate to your CARTO deployment domain, and it should use your IdP to log into the platform.
