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

# License

The license is a critical component of the DEP Power Platform. Without a valid license, the platform runtime will not start.
Therefore, it is essential to ensure a valid license is in place before launching the runtime.

## Request License

If you do not have a license, or if your current license is about to expire, contact the Power Platform support team to request a license.

An expired license will cause the Power Platform controller to shut down, leaving the system unusable and uncontrollable.
To avoid downtime, ensure that your license is renewed before it expires.

When requesting a license, you will need to provide the controller **UUID**.
This ensures that the generated license is securely tied to your specific controller and cannot be used on any other device.

### Retrieve Controller UUID

<Steps>
  <Step title="Login to the WBM">
    <Card title="Login to the WBM" icon="lock-open" href="/installation/settings/login" horizontal>
      Login to the Web-Based Management (WBM) interface of the Power Platform controller.
    </Card>
  </Step>

  <Step title="Navigate to the Configuration Tab">
    Navigate to the **Configuration** tab in the left navigation plane and select **PLCnext Store**.
  </Step>

  <Step title="Copy Controller UUID">
    Copy the controller **UUID** from the PLCnext Store page, under System Information.
  </Step>
</Steps>

<img src="https://mintcdn.com/directenergypartners/NUG_FidRKWJZAe9-/images/wbm_configuration_plcnext_store.png?fit=max&auto=format&n=NUG_FidRKWJZAe9-&q=85&s=173dd22ba63ec2b59ac83c03adb651fa" alt="PLCnext Store" style={{ margin: 'auto' }} width="1911" height="904" data-path="images/wbm_configuration_plcnext_store.png" />

<Note>
  For license requests or updates, please reach out to the support team at [pplsupport@directenergypartners.com](mailto:pplsupport@directenergypartners.com).
  Make sure to include the controller **UUID** in your request.
</Note>

## Upload License File

Once you have obtained a valid license, it must be uploaded to the Power Platform controller to enable the runtime.
The license file is named **license.txt** and must be placed in the following directory on the controller:

```bash theme={null}
/opt/plcnext/appshome/data/60002172000969
```

There are multiple ways to upload the license file:

### Using SCP (Secure Copy)

<Steps>
  <Step title="Open Terminal">
    Open a terminal on your local machine.
  </Step>

  <Step title="Copy License File">
    Use the scp command to copy the license file to the controller:

    ```bash theme={null}
    scp /path/to/license.txt admin@<controller_ip>:/opt/plcnext/appshome/data/60002172000969/
    ```

    <ul>
      <li>Replace **/path/to/license.txt** with the path to your local license file.</li>
      <li>Replace **controller\_ip** with the IP address of your controller.</li>
      <li>Enter the admin password when prompted.</li>
    </ul>
  </Step>

  <Step title="Verify File Upload">
    Verify the file has been uploaded by connecting to the controller via SSH and running:

    ```bash theme={null}
    ls -l /opt/plcnext/appshome/data/60002172000969
    ```
  </Step>
</Steps>

### Using FileZilla

<Steps>
  <Step title="Open FileZilla">
    Open FileZilla (or another SFTP client) on your local machine.
  </Step>

  <Step title="Connect to Controller">
    Connect to the controller using:

    <ul>
      <li>Host: `controller_ip`</li>
      <li>Username: `admin`</li>
      <li>Password: `admin password`</li>
      <li>Port: `22`</li>
    </ul>
  </Step>

  <Step title="Navigate to Folders">
    <ul>
      <li>Navigate on the controller side to: `/opt/plcnext/appshome/data/60002172000969`</li>
      <li>Navigate on your local machine side to the folder containing license.txt.</li>
    </ul>
  </Step>

  <Step title="Drag and Drop License File">
    Drag and drop **license.txt** from your local machine to the controller folder.
  </Step>

  <Step title="Verify File Transfer">
    Verify the file transfer was successful.
  </Step>
</Steps>

### Other Methods

Any method that allows transferring files over SSH or SFTP (e.g., WinSCP, rsync) can be used, as long as the license ends up in:
`/opt/plcnext/appshome/data/60002172000969`.

## Reboot Controller

After uploading the license, reboot the Power Platform controller to ensure the new license is applied.

### Through WBM

<Steps>
  <Step title="Login to the WBM">
    <Card title="Login to the WBM" icon="lock-open" href="/installation/settings/login" horizontal>
      Login to the Web-Based Management (WBM) interface of the Power Platform controller.
    </Card>
  </Step>

  <Step title="Navigate to the System Tab">
    Navigate to the **System** tab in the left navigation plane and select **Device Maintenance**.
  </Step>

  <Step title="Restart Controller">
    Click on **Restart The Device** to reboot the controller.
  </Step>
</Steps>

<img src="https://mintcdn.com/directenergypartners/NUG_FidRKWJZAe9-/images/wbm_system_maintenance_restart.png?fit=max&auto=format&n=NUG_FidRKWJZAe9-&q=85&s=6e40beabc788dedddcfaa1fcc87720d2" alt="Restart The Device" style={{ margin: 'auto' }} width="1891" height="901" data-path="images/wbm_system_maintenance_restart.png" />

### Through Shell Session

<Steps>
  <Step title="Open Terminal">
    Open a terminal on your local machine and connect to the controller using SSH:

    ```bash theme={null}
    ssh admin@<controller_ip>
    ```

    Enter the admin password when prompted.
  </Step>

  <Step title="Reboot Controller">
    ```bash theme={null}
    sudo reboot
    ```
  </Step>
</Steps>

## Verifying the License

After uploading and rebooting the controller, you should verify that the license file has been correctly recognized.

<Steps>
  <Step title="Connect to Controller">
    Connect to the controller via SSH through the terminal on your local machine:

    ```bash theme={null}
    ssh admin@<controller_ip>
    ```
  </Step>

  <Step title="Navigate to Log Folder">
    ```bash theme={null}
    cd /opt/plcnext/appshome/data/60002172000969/log
    ```
  </Step>

  <Step title="Open License Log File">
    Open the license.log file to check for the license status:

    ```bash theme={null}
    nano license.log
    ```
  </Step>
</Steps>

<Check>
  If the license is valid, the log should contain a message indicating that the license is valid and successfully loaded.
</Check>

<Warning>
  If the log reports an error (e.g., license expired, invalid, or missing), double-check that the file is in the correct location and named license.txt, then reboot the controller again.

  If the error persists, contact the support team at [pplsupport@directenergypartners.com](mailto:pplsupport@directenergypartners.com) and provide the **license.log** file for further assistance.
</Warning>