Skip to main content





Get a license file for an environment

  • Edit
    Collaborate with us
    Edit this page on GitHub
  • This article contains the steps to obtain OutSystems licensing files, which are required while installing and upgrading your OutSystems self-managed environments.

    OutSystems Cloud environments

    The OutSystems team manages all the licensing of your OutSystems Cloud environments. When you get a new cloud environment, it's already activated and ready to use.

    Self-managed environments

    For your self-managed environments, you'll need to obtain and install the license in each environment. To reach the Customer Portal from Service Center, follow these steps:

    1. In Service Center at http://<yourenvironment>/ServiceCenter, navigate to the 'Administration' tab and then to the Licensing submenu.

    2. Click the Request a New License link.

      You'll be redirected to the Customer Portal and, after logging in, you'll be able to pick the infrastructure you're managing:

    If your infrastructure isn't visible in the drop-down, you aren't associated with that infrastructure in your Customer portal. Only authorized members will be able to access.

    Once in Customer Portal, you'll need to:

    1. Register the environment.
    2. Get the license file.
    3. Install it in your environment.

    Check the following sections for instructions.

    Registering your environment

    To obtain a license, you'll first need to register the environment using its serial number. Registering an environment consists in associating the serial number (obtained in Service Center) with an environment slot and allows you to download a license file. If you haven't yet registered your environment on the Customer Portal, follow these steps:

    1. Scroll down on the page to find an environment that doesn't have an associated serial number, taking special care to select the right "environment type":

      The image above shows an infrastructure with a single environment of type "Development". What you see on this page depends on your OutSystems subscription.

    2. Click Register Environment, and enter the serial number of the environment that's obtained from Service Center.

    Don't have any more environments available? See how to free up an existing environment or contact your OutSystems account manager.

    Getting the license file

    The environment is now associated with the serial number and you can download the license file:

    The permissions to download license files are managed at the Customer Portal.

    • Was this article helpful?