# Add Plex accounts

{% hint style="warning" %}
If you do not plan on managing Plex servers, you can skip this section.
{% endhint %}

To enable Streams Manager to manage your Plex users and servers, it needs to have access to your Plex accounts. Also, before any of your Plex users can register, at least one Plex account needs to be configured to be able to validate that an email address a user is trying to register with is an email address that is already registered on [https://plex.tv](https://plex.tv/).

To add a Plex account, follow these steps:

* Click on `Servers & Libraries -> Plex Accounts` in the main menu
* Plex Accounts panel will open showing already configured Plex accounts (if any)
* Click the menu button in the table header to reveal the action menu and click on Add Plex Account
* Modal dialog will show asking you for the following information:
  * **Email** - email for your Plex account 
  * **Password** - (Optional) password for you Plex account. This field is not required to be saved in the system but it is highly recommended to do so. Otherwise, if your Plex token expires or gets invalidated, the system will have no way of generating a new token and all operations the system tries to perform on your Plex account or servers will fail
  * **Authentication token** - authentication token (Plex token) used to authorize calls to Plex. To generate the token, you can use the steps outlined in this [Plex support article](https://support.plex.tv/articles/204059436-finding-an-authentication-token-x-plex-token/) or get it from the URL as outlined below in Extra query parameters
  * **Proxy Url** - (Optional but recommended) Url of your proxy server. If provided, Streams Manager will proxy all requests to `plex.tv` domain through this proxy. This is an additional security measure to ensure that your account is not accessed from Streams Manager's IP address. You can use any HTTP proxy but it is highly recommended to run the proxy on the same machine where your Plex Media Server is running. This will ensure all traffic appears to be coming from the same machine where Plex Media Server is running.
  * **Proxy username** - Username for the proxy. Required if proxy url is specified.
  * **Proxy password** - Password for the proxy. Required if proxy url is specified.
  * **Extra query parameters** - (Optional but recommended) Extra query parameters to set on calls sent to `plex.tv` . The purpose is to make the calls that Streams Manager makes to `plex.tv` appear exactly like the calls coming from the Plex web app. To get the query string, follow these steps:

    * Navigate to <https://app.plex.tv> and login
    * Go to Settings (wrench icon)
    * Open Developer Tools in your browser and open `Network` tab
    * Click on `Manage Library Access.`You should see requests in the `Network` tab
    * Find the request that looks like the request in this image:
    *

    ```
    <figure><img src="/files/vsL5NyRMJ7kxw6ZKBxGu" alt=""><figcaption></figcaption></figure>
    ```

    * Copy the request URL and paste in a text editor. Strip everything before and including  `requests?` . What is left should start with `X-Plex-Product`
    * Find the section `&X-Plex-Token=xxxxxxx` where `xxxxxx` will be your personal token and remove it (do not remove `&` after the token)
    * Copy the remainder and put in the Extra query parameters box in Streams Manager
  * **Has Plex pass** - indicates whether this account has Plex pass which is needed to utilize advanced functionality such as streaming enforcement, enabling downloads, etc.
* <mark style="color:red;">**Make sure to test the Proxy settings first before testing your token.**</mark>
* Click Test Token button and ensure you get a success message
* Save the Plex account details by clicking the Save button


---

# Agent Instructions: 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:

```
GET https://streamsmanager.gitbook.io/streams-manager/configuration/add-plex-accounts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.