Skip to main content

Setting Up OutSystems



OutSystems system requirements

This article applies to: OutSystems 11  Other versions available: 109.19.0

Before installing OutSystems on-premises, check its hardware and software requirements. Once you're ready to start the installation, head to Setting Up OutSystems.

Platform Server

This section summarizes the requirements for installing the Platform Server in your data center.

Supported configurations

Hardware (minimum requirements) Operating System Application Server Database Management System Additional Software Requirements
• Dual-core processor;
• 4 GB of RAM;
• 80 GB of disk space.
• Microsoft Windows Server 2019 (Standard Edition or higher edition);
• Microsoft Windows Server 2016 (Standard Edition or higher edition).
• Microsoft Internet Information Services (IIS) 10.0 or higher configured with a valid SSL certificate emitted by a public Certificate Authority. • Microsoft SQL Server 2017 (Web Edition or higher edition);
• Microsoft SQL Server 2016 (Web Edition or higher edition);
• Microsoft SQL Server 2014 (Web Edition or higher edition);
• Azure SQL Database V12;
• Oracle 12c (12.1 or 12.2, Standard Edition or Enterprise Edition).
• Microsoft .NET Framework 4.7.2;
• Microsoft Build Tools 2015;
•.NET Core 2.1 Runtime & Hosting Bundle for Windows.

The supported Operating System configurations mentioned in the above table need to be deployed on bare metal or hardware virtualization technologies (e.g. VMware, KVM).

Future revisions of OutSystems may require the installation of an update of any of these components, within the major versions mentioned in the above table.

Apart from standard Oracle Database setups, OutSystems Platform 8.0 and onwards works with Oracle Exadata Database Machines running with Oracle Linux 5.5 or higher.

Cache Invalidation Service

OutSystems Cache Invalidation Service requires a RabbitMQ Server version 3.7.x with Erlang version 20.x.

While installing the OutSystems Platform Server you will be provided with a script that simplifies the local installation of these two components. Alternatively, you can use an existing RabbitMQ Server and Erlang installation as long as it fulfills the same version requirements.

Amazon EC2 considerations

OutSystems can run on Amazon EC2 instances. Each instance must fulfill the following requirements:

  • The EC2Config service must be running

For more information on how to enable this service check Amazon's EC2Config service documentation.

Amazon RDS considerations

OutSystems supports Microsoft SQL Server 2016, Microsoft SQL Server 2017, and Oracle 12c on Amazon RDS. The database instance class must fulfill the following requirements:

  • 1 vCPU (virtual central processing unit) or higher
  • 1 ECU (EC2 Compute Unit) or higher
  • 3.75 GiB of memory or higher
  • "Moderate" network performance or higher

Example of a DB instance class fulfilling these requirements: "db.t2.medium".

Check Amazon's DB Instance Class topic for more information on the available DB instance classes. Be sure to also check Amazon RDS System Requirements to learn about Amazon RDS limitations.

Microsoft Azure considerations

OutSystems supports Microsoft Azure SQL Database V12 with the following considerations:

  • The MDC (Multiple Database Catalogs) feature is not supported.
  • Connecting to Azure SQL using Windows Authentication is not supported.
  • The database service tier must be at least "S3".
  • Currently, Azure SQL does not support customizing the timezone from UTC.

OutSystems also supports SQL Server running on an Azure Virtual Machine.

Integration with external systems

The following systems are certified to integrate with OutSystems.

SQL Server Database

  • Microsoft SQL Server 2017
  • Microsoft SQL Server 2016
  • Microsoft SQL Server 2014
  • Microsoft SQL Server 2012
  • Microsoft SQL Server 2008 R2
  • Microsoft SQL Server 2008

Azure SQL Database

  • Azure SQL available in the cloud

Oracle Database

  • Oracle 12c (12.1 and 12.2, Standard Edition or Enterprise Edition)
  • Oracle 11g R2 (Standard Edition or Enterprise Edition)
  • Oracle 10g R2 (Standard Edition or Enterprise Edition)

The NLS_CHARACTERSET must be set to WE8MSWIN1252 or AL32UTF8.

MySQL Database

  • MySQL 5.6 (5.6.5 or later within the 5.6 version, all editions)
  • MySQL 5.7 (5.7.22 or later within the 5.7 version, all editions)

IBM Database

  • DB2 for iSeries V6R1 or higher

The installation of the IBM iAccess software is required in all Front-End and Deployment Controller server machines.

The use of double-byte characters with DB2 databases is not supported.


  • SAP ERP R/3 4.6 or higher
  • SAP ECC 5.0 or higher

Development tools

To develop your applications using OutSystems, developers need to install Service Studio and Integration Studio development tools on their desktops.

Installation requirements for these tools are as follows.

Hardware (minimum requirements)

  • 1.8 GHz dual-core processor (or better)
  • 2 GB RAM (4 GB recommended)
  • 1 GB of hard-disk space


  • The touch feature of touch screen devices is not supported, however, you can use touch screen devices with keyboard and mouse.

Supported Operating Systems

  • Windows 10
  • Windows 8
  • Windows 7
  • Microsoft Windows Server 2008 R2
  • Microsoft Windows Server 2012 R2
  • Microsoft Windows Server 2016

For the versions above, OutSystems only supports Windows editions that are supported by Microsoft.

Required Software

  • Microsoft .NET Framework 4.6 (or higher);

  • To integrate with external systems using Integration Studio:
    Visual Studio 2015 or Visual Studio 2017, to edit the source code of Extension Actions;

  • To perform client-side debugging in Service Studio using a desktop browser:
    Google Chrome version 54 or later;

  • To perform client-side debugging on an Android mobile device:
    Android device drivers, if the device is not recognized automatically;

  • To perform client-side debugging on an iOS mobile device:
    iTunes 12.1.3 or later.

Required Network Connection

Minimum speed of 1 Mbps for both downloading and uploading.

These requirements apply, even when installing the development tools on a virtual machine.

End-user requirements

Desktop Browsers (Web applications)

  • Internet Explorer 11
  • Edge (latest stable version)
  • Firefox (latest stable version)
  • Google Chrome (latest stable version)
  • Safari (latest stable version)

Mobile Device Browsers (Web applications)

  • iOS 7 or higher
  • Android 4.1 or higher
  • Windows Phone 8 or higher

Note that only the default browsers of the operating systems listed above are supported.

Mobile Apps

The minimum requirements depend on the Mobile Apps Build Service (MABS) version used to generate your mobile apps.

Note: Only official Android and iOS ROMs are supported.

OutSystems Now

  • iOS 8 or later
  • Android 4.4 or later

Containers considerations

Containers only expose HTTP port 80. HTTPS connections must be ensured by the load balancer, following an SSL offload scenario.

Follow the instructions in End-to-end SSL and SSL Offloading: you do not need to follow the step instructing you to insert a record in the OSSYS_PARAMETER table, since the platform already performs this task when deploying an application to containers.

Docker Containers

To deploy OutSystems applications to Docker containers you will need a Docker infrastructure able to run standard Docker Windows Server containers, i.e. Windows Server containers that only use the functionality provided by default in a Docker installation.


The minimum required Docker infrastructure consists of a Docker Engine installation, i.e. the client-server technology that builds and runs containers using Docker components and services. The engine must support and be able to run Windows Server containers.

The minimum recommended Docker version is the following:

  • Docker client/server version 17.10

The machine running Docker must fulfill the following OS requirement:

  • Windows Server 2016 (version 1709 or later)

OutSystems also supports the following Docker-based hosting technologies:

  • Amazon ECS (Elastic Container Service)
  • Azure Container Service (ACS)

If you are using Amazon please read the Amazon Elastic Container Service documentation. If you are using Azure please read the documentation on Azure for Containers documentation.

The Docker Secrets functionality is not supported, since its support on Windows containers is not yet ready for production use.

Docker Registries

While having a Docker registry is not mandatory, it is highly recommended. You can use any Docker registry as long as it supports storing and retrieving images for Windows Server containers.

For example, you can use one of the following docker registries (either on-premises or in the cloud):

  • Docker Hub
  • Docker Trusted Registry

Container Cluster Orchestrators

When deploying an OutSystems application in a Docker container it's necessary to map port 80 exposed by the container to an available port in the container host (usually a high-numbered port selected by the container runtime).

Since this port in the container host may change and each container needs at least port 80 mapped in the container host machine, the recommended approach is to set up a container cluster, together with a container cluster manager/orchestrator, that seamlessly handles all the routing to the right container and port.

You can use OutSystems with the following container cluster orchestrators:

  • Docker Swarm
  • Google Kubernetes
  • Amazon Elastic Container Service

If you are using Docker Swarm, please read the official Docker Swarm documentation. If you are using Kubernetes, please read the official Kubernetes documentation that includes detailed instructions on using Kubernetes with a cluster.

The container cluster manager/orchestrator can be installed anywhere as long as it allows you to manage the Docker engine on which you will be running the containers with OutSystems applications.

Base Image Availability

Ensure that all machines that will build/run the application images have the microsoft/dotnet-framework:4.7.2-runtime base image present in the machine. If the base image is not in the machine, the first build/run may timeout while the base image is downloaded.

Pivotal Cloud Foundry

To deploy your OutSystems applications to Pivotal Cloud Foundry (PCF) you will need to have access to a PCF infrastructure. It must be able to run Windows stemcells, i.e. you will need to install a Windows tile in your infrastructure.


The PCF infrastructure must have a Pivotal Application Service for Windows tile installed. To install a Windows tile, follow the instructions provided by Pivotal for the Windows 2016 tile.

Note: The Windows 2012r2 tile is not supported.

PCF Internal Routing

You will need to ensure that your PCF internal router can route requests to OutSystems applications both when these come from your internal network, as well as when coming from the outside.

We recommend adding two domains to your Pivotal Apps Manager's "org" (organization):

  • A subdomain of your main shared domain that will be used as the PCF's deployment zone address. All the modules of each OutSystems application deployed to this zone will be mapped here. Example: If your main shared domain is, add a new domain called

  • A domain equal to the public address of your main load balancer and reverse proxy. This lets the PCF internally route requests coming from outside your internal network. Example: If your main load balancer and reverse proxy is publicly accessible using, add exactly this value as a new domain.

Command-line Tools (cf CLI)

The deployment instructions provided by OutSystems use the Cloud Foundry Command Line Interface ("cf CLI") tool provided by Pivotal.

You must install "cf CLI" on the machine executing the deployment to PCF to be able to run the cf command-line executable.

You will also need to log in to Cloud Foundry using "cf CLI", specifying an API endpoint and an "org" (organization), before you are able to run commands like cf push successfully.