> ## Documentation Index
> Fetch the complete documentation index at: https://syteca.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage the Serial Key

> View, activate, update, deactivate, and proxy-configure the Syteca product license serial key on the Serial Key Management tab in the Management Tool.

Everything you do to a serial key happens on the **Serial Key Management** tab of the Configuration page. This page covers viewing it, activating it (online or offline), updating it, configuring a web proxy for activation, and deactivating it.

<Note>
  These tasks require the [Tenant Management and System Configuration administrative permission](/docs/administration/users/administrative-permissions), and you must belong to the built-in default tenant.
</Note>

## View the serial key and licenses

<Steps>
  <Step title="Open the page">
    Sign in to the Management Tool and click the **Configuration** button at the top.
  </Step>

  <Step title="Open the Serial Key sub-tab">
    On the **Serial Key Management** tab, the **Serial Key** sub-tab is shown by default.
  </Step>
</Steps>

The top of the page shows the serial key's metadata:

| Field                                | Shows                                                                                                                                                                  |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Key**                              | The serial key (number).                                                                                                                                               |
| **Activation Date**                  | When the serial key was activated.                                                                                                                                     |
| **Update & Support period end date** | When the [Update & Support period](/docs/administration/licensing/overview#the-update-&-support-period) expires (based on activation date plus subscription length).        |
| **Type**                             | The [serial key type](/docs/administration/licensing/overview#serial-key-types) — Permanent, Subscription, Trial, Not-for-Resale, SaaS, SaaS Trial, or SaaS Not-for-Resale. |
| **State**                            | Activated, Deactivated, or Expired.                                                                                                                                    |
| **Unique identifier**                | The hardware ID of the computer the Application Server is installed on.                                                                                                |

The **Applications** section shows which of the four applications (and which features within each) are enabled — gray toggles or gray feature names mean disabled.

<Note>
  Application toggles and gray features can only be changed by your Syteca vendor updating your serial key. You enable them by purchasing them.
</Note>

### Seat Licenses and Endpoint Licenses

Below the applications, two sections show what's available and what's in use:

* **Seat Licenses** — for PAM users (also called PAM seat licenses or Password Management seat licenses). See [Assign PAM seat licenses](/docs/administration/licensing/assign-pam-seat-licenses).
* **Endpoint Licenses** — for endpoint computers. Each row is a custom endpoint license type contained in your serial key, with the columns:

| Column          | Shows                                                                                                                                                                                                                |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**        | A custom name for this endpoint license type.                                                                                                                                                                        |
| **Details**     | The applications and features enabled, plus the **Maximum number of concurrent sessions** per Client.                                                                                                                |
| **Default For** | Set this row as **Default for Workstations** or **Default for Servers** — used by [automatic endpoint license assignment](/docs/administration/licensing/assign-endpoint-licenses#automatic-floating-license-assignment). |
| **In Use**      | The number of licenses currently assigned to Clients, out of the total available.                                                                                                                                    |

The default operating system assignments are:

| Default For                  | Operating systems                                                                                                                    | Max concurrent sessions |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ----------------------- |
| **Default for Workstations** | Windows desktop; macOS; Linux/Unix Server *(X11 GUI sessions only)*                                                                  | 1                       |
| **Default for Servers**      | Windows Server *(including Terminal Services, Citrix, or Published App Server)*; Linux/Unix Server *(both X11 GUI and SSH sessions)* | 2+ or Unlimited         |

<Note>
  Only one row can be **Default for Workstations** and only one row can be **Default for Servers** at any time.
</Note>

<Frame caption="The Serial Key sub-tab with metadata, applications, seat licenses, and endpoint licenses.">
  <img src="https://mintcdn.com/syteca/FKrkO8bEqEQ6WSgs/images/administration/licensing/serial-key-subtab.png?fit=max&auto=format&n=FKrkO8bEqEQ6WSgs&q=85&s=d14392376b6a4810fdf46d169340e662" alt="Serial Key sub-tab showing all license information and application toggles" width="1919" height="972" data-path="images/administration/licensing/serial-key-subtab.png" />
</Frame>

<Info>
  In **Multi-Tenant mode**, a **Licenses Granted** sub-tab also appears, where the technician views and changes the number of licenses granted to each tenant. See [Granting licenses to tenants](/docs/administration/licensing/assign-endpoint-licenses#multi-tenant-mode-—-granting-licenses-to-tenants).
</Info>

## Activate or update the serial key

Activation modes depend on whether the Application Server computer has Internet access. Whenever your vendor updates your serial key on their side, you also need to update it here for the changes to take effect.

<Tabs>
  <Tab title="Online">
    <Info>
      Online activation requires an Internet connection on the Application Server computer. If the computer is behind a corporate web proxy, see [Configure a web proxy for activation](#configure-a-web-proxy-for-activation) first.
    </Info>

    <Steps>
      <Step title="Open Serial Key Management">
        Click **Configuration** at the top of the Management Tool, then go to the **Serial Key Management** tab.
      </Step>

      <Step title="Activate or update">
        On the **Serial Key** sub-tab:

        * **To activate a new serial key:** *(not available in SaaS)* click **Activate Product** in the top right and choose **Activate Product Online**. In the **Serial Key Activation** pop-up, paste the serial key and click **Activate**.
        * **To update an existing serial key:** click **Update Key State** in the top right.
      </Step>

      <Step title="Confirm the result">
        The activated or updated serial key is displayed on the Serial Key Management tab, with the number of licenses available and the Update & Support period end date.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Offline">
    <Info>
      Offline activation is for environments where the Application Server has no Internet connection. **Not available in SaaS.**
    </Info>

    If the Application Server computer has no Internet, you can activate (or update) the serial key on the Syteca website first, then add it in the Management Tool in offline mode.

    Follow the offline activation instructions on the Syteca website.
  </Tab>
</Tabs>

## Configure a web proxy for activation

<Info>
  **Not available in SaaS.**
</Info>

If the Application Server reaches the Internet through a corporate proxy, configure the proxy in the server configuration file before activating online.

<Steps>
  <Step title="Open the server configuration file">
    On the Application Server host, open `EkranServer.exe.conf` in a text editor. The default location is:

    ```text theme={"system"}
    C:\Program Files\Ekran System\Ekran System\Server
    ```
  </Step>

  <Step title="Edit the proxy configuration">
    The right edit depends on your Syteca version.

    <AccordionGroup>
      <Accordion title="Syteca 6.47.1 or later">
        In the `<appSettings>` section, add a single line with your proxy address and port:

        ```xml EkranServer.exe.conf theme={"system"}
        <appSettings>
          <!-- ... -->
          <add key="LicensingPortalProxyAddress" value="http://10.0.0.000:10" />
          <!-- ... -->
        </appSettings>
        ```
      </Accordion>

      <Accordion title="Versions before 6.47.1">
        In the `<basicHttpBinding>` section, set `proxyAddress` and `useDefaultWebProxy="false"` on each binding:

        ```xml EkranServer.exe.conf theme={"system"}
        <basicHttpBinding>
          <binding name="GetLicenseBinding"            proxyAddress="http://10.0.0.000:10" useDefaultWebProxy="false" />
          <binding name="GUIDDeactivationBinding"      proxyAddress="http://10.0.0.000:10" useDefaultWebProxy="false" />
          <binding name="GetLicensesByHwidBinding"     proxyAddress="http://10.0.0.000:10" useDefaultWebProxy="false" />
          <binding name="GetTrialBinding"              proxyAddress="http://10.0.0.000:10" useDefaultWebProxy="false" />
          <binding name="GetLicenseByGuidBinding"      proxyAddress="http://10.0.0.000:10" useDefaultWebProxy="false" />
          <binding name="GetActualVersionBinding"      proxyAddress="http://10.0.0.000:10" useDefaultWebProxy="false" />
        </basicHttpBinding>
        ```
      </Accordion>
    </AccordionGroup>
  </Step>

  <Step title="Restart the service">
    Restart the **EkranServer** service.
  </Step>

  <Step title="Activate the serial key">
    Activate the serial key as described under [Activate or update the serial key](#activate-or-update-the-serial-key).
  </Step>
</Steps>

## Deactivate the serial key

<Info>
  **Not available in SaaS.** An expired serial key cannot be deactivated.
</Info>

If you decide to discontinue using Syteca, deactivate the serial key.

<Steps>
  <Step title="Confirm prerequisites">
    Make sure the Application Server computer has Internet access.
  </Step>

  <Step title="Open Serial Key Management">
    Click **Configuration** at the top of the Management Tool, then go to the **Serial Key Management** tab.
  </Step>

  <Step title="Deactivate">
    Click **Deactivate Key** on the right.
  </Step>

  <Step title="Confirm">
    In the confirmation message, click **Deactivate**.
  </Step>
</Steps>

The State field on the Serial Key Management page now shows **Deactivated**.

## Related

<CardGroup cols={2}>
  <Card title="Licensing overview" icon="key" href="/docs/administration/licensing/overview">
    Serial key types, contents, and the Update & Support period.
  </Card>

  <Card title="Assign PAM seat licenses" icon="users" href="/docs/administration/licensing/assign-pam-seat-licenses">
    Assign PAM seat licenses to users.
  </Card>

  <Card title="Assign endpoint licenses" icon="laptop" href="/docs/administration/licensing/assign-endpoint-licenses">
    Manual, automatic, and Multi-Tenant license assignment.
  </Card>

  <Card title="System Health dashboards" icon="activity" href="/docs/administration/dashboards/system-health-dashboards">
    Monitor licensed Client status.
  </Card>
</CardGroup>