Change the license file location

This topic describes how to specify a custom location for storing a license file instead of the default, when you Add a workstation license for Arm Forge or Set up a floating license for Arm Forge.

Before you begin

  • A workstation license, is a single file supplied by Arm.
  • A floating license includes two files: Server license file (license.<license number>), and client license file (license).
  • Server license file names must begin with license, or the variant spelling licence.
  • License file names are not case sensitive.
  • You can append unique identifiers to license file names for storing multiple licenses in the same directory. For example, add the server license serial number, license.server.1234, or include client in the client license name, license.client.5678.
  • Ensure that you have suitable administrative permissions for performing these tasks on the target machines.


  1. Copy the client license file to a custom directory location.
    Note: Do not edit the contents of the license file because doing so might prevent the license from working.
  2. Configure the ALLINEA_LICENSE_DIR environment variable to find the custom license location:
    Note: You can also use ARM_LICENSE_DIR.

    export ALLINEA_LICENSE_DIR=</custom path>/licenses
  3. If you have multiple licenses for Arm Forge tools (Arm DDT, Arm MAP, Arm Performance Reports) copy the license files to the product installation directory:

    /{installation path}/arm/forge/<version>/licences

Related information