---
title: "Add a reporting token to a package (deprecated)"
description: "Deprecated: add a usage reporting token to a Compatibility Package. Kept for older packages."
product: "Alchemy"
edition: "Public"
type: "reference"
url: "https://docs.cloudhouse.com/public/licensing-and-reporting/deprecated/deprecated-add-a-reporting-token/"
---
# Add a reporting token to a package (deprecated)

Applies to: `Alchemy`

!!! warning

    This article refers to deprecated functionality which is retained for those customers running earlier releases of our products.
    For current versions of Cloudhouse Alchemy Compatibility Packages, please refer to [Licensing and Usage Reporting](https://docs.cloudhouse.com/public/licensing-and-reporting/licensing-and-usage-reporting-overview/index.md) for the most up-to-date information.

Containers require a reporting token to report usage events to <https://containers.cloudhouse.com>.

1. If you dont have an HTTPS Reporting token for your customer already, one can be requested from [support@cloudhouse.com](mailto:support@cloudhouse.com).
2. You will receive your HTTPS Usage Reporting token via secure email, open the link in the email and provide your email address to download the file.
3. The token file is a text file, named usage-customername.token, and formatted using JSON so that you view the contents of the file in a text editor. If the editor supports JSON then formatting will applied.

    ```
    {
       "token": "%Token%",
       "clientid": "%ClientId%",
       "deviceid": "%DeviceId%",
       "description": "Usage token is allocated to %Partner% to report Container usage on behalf of %Customer%."
    }
    ```

4. Once you have created the Container, copy the .token file into the Container's root folder OR use the Container Editor - refer to [Updating, Editing and Maintaining a Cloudhouse Compatibility Container](https://docs.cloudhouse.com/z-alchemy-draft-docs/updating-editing-and-maintaining-a-cloudhouse-compatibility-container)‍.
5. Check that `chmetadata.json` contains the following entries, if not add them.

    ```
    "AuthUrl": "https://auth.cloudhouse.com/oauth/token",
    "UsageReportingUrl": "https://containers.cloudhouse.com/api/UsageEvents"
    ```

6. The token will be encrypted when the Container is deployed, the extension will change to .stoken and HTTPS reporting will be used to send usage data to Cloudhouse.

Embedded content from <https://www.youtube.com/watch?v=0syalyE7HE4>

## Applies to

Container version must be 4.5.249.480, or later.