Skip to main content





Configure your OutSystems environment

  • Edit
    Collaborate with us
    Edit this page on GitHub
  • This article applies to: OutSystems 11

    When installing the Platform Server in an environment, the installation checklist will ask you to configure Service Center, which is the management console of your OutSystems environment.

    The Service Center console of a specific environment (eg. Development, Test, Production) is accessible through the url http://<your_server>/ServiceCenter.

    Configure your environment

    The configuration of your environment is done in the Administration > Environment Configuration area in Service Center console:

    When installing the Platform Server for the first time, you must configure the following settings:

    • Hostname

    • Purpose

    • Debug Mode


    The Purpose of an OutSystems environment defines the main objective of the environment in the infrastructure. OutSystems changes its behavior to better fit the needs of each purpose, which reflects in optimizations and the availability of specific features.

    The environment Purpose should only be changed when an environment is being configured for the first time or right after an upgrade to OutSystems 11. Besides those two moments, the Purpose should be stable throughout the life of an environment.

    In case you need to change the environment Purpose, the new configuration is applied to all modules automatically.

    This setting must be set to one of the following values:


    Environments whose main purpose is to create and develop applications, requiring a fast feedback loop. Development environments use several 1-Click Publish process optimizations, like differential compilation, and allow testing/previewing data in Aggregates and SQL Queries, viewing data in Entities and using Personal Areas.


    Environments whose main purpose is to make applications available to your end users. In Production environments, reliability is a top priority so 1-Click Publish process optimizations are disabled; as a consequence, publishing an application in a Production environment can take longer than publishing the same application in a Development environment.


    Environments whose main purpose is to provide a real scenario (similar to Production) where developers can test your applications and mitigate the risk of deploying them to Production while keeping features that can assist developers with debugging. In Non-Production environments 1-Click Publish process optimizations are disabled (just like Production environments) and it is still possible to test SQL Queries and preview data in Aggregates and SQL Queries (like Development environments).

    Management (LifeTime)

    This is where LifeTime, the infrastructure management console, lives. An environment with this purpose requires stability, and that’s why they also behave similarly to environments with Production purpose, with no optimizations being done.

    The Purpose you can configure for the environment is subject to the environment's license.

    Feature availability for different Purposes

    Legend: Yes Available; YesX Available with restrictions; No Not available

    Feature / Purpose Development Non-Production Production Management (LifeTime)
    1-Click Publish process optimizations1 Yes No No No
    Publishing of solution continues with errors2 Yes Yes No No
    Publishing the Current Running Version refreshes dependencies3 Yes No No No
    Preview in Devices Yes Yes YesA Yes A
    Test/preview data in Aggregates and Queries Yes Yes No No
    View Data in Entities Yes Yes No No
    Test and debug in Personal Area YesB No No No
    Delete Module in Service Studio Yes No No No
    Replace Module in Service Studio4 Yes No No No

    1- Optimizations that only concern the performance of the 1-Click Publish process; 2- When not available the publish process will stop and ask the user if it should abort or continue; 3- Publishing the Current Running Version of a solution ensures all dependencies are refreshed; 4- By publishing a module with the same name.

    A- Requires enabling the site property AvailableInProductionMode in PreviewInDevices Module; B- Requires enabling the Module's Debug Mode.

    Environment Debug Mode

    The Debug Mode of an OutSystems environment determines if Modules in that environment can be debugged in Service Studio.

    To be able to debug a Module in Service Studio, both the environment Debug Mode and the Module Debug Mode must be enabled.

    Disabling the environment Debug Mode

    Disables the Debug Mode for each Module in the environment.

    When the Debug Mode of the environment is disabled it is not possible to enable the Debug Mode for any of the Modules.

    Enabling the environment Debug Mode

    Allows you to manually enable the Debug Mode for Modules you want to debug.

    Changes in Debug Mode will only affect Modules after they have been republished; read more about applying compile-time configurations.

    Note: When disabling the Debug Mode of an environment you will only need to republish the Modules whose Debug Mode was previously enabled.

    When you publish a Module for the first time, the Debug Mode of the Module is set according to the Debug Mode of that environment.