GeneXus Server exposes web pages and services over HTTP. If your server will be behind a proxy, make sure it supports HTTP 1.1 through proxy connections. Check the common issues page for more information.
Below are the minimum hardware and software requirements for installing and running GeneXus Server.
Processor: 2.0 GHz with at least two cores
RAM: 4 GB minimum.
Free Hard disk space: 2 GB for the installation and temporal files. Hosted Knowledge Bases require additional space.
These requirements are for the installation of a single GeneXus Server instance. An additional 1 GB of RAM is recommended for each new instance in a server machine with a low load. For heavy loads on the server machine, the recommendation is 2 GB (and for working with big Knowledge Bases as well).
GeneXus Server uses up to 2 GB of RAM when processing a Commit or Update with numerous changes. Therefore, minimum settings are not recommended for working with large-size Knowledge Bases.
Windows Server 2008 SP2 or Higher
Only Server Operating systems are supported for a production environment. GeneXus Server may also be installed on client operating systems (Windows 7 SP1 or higher), though only for demo or proof-of-concept purposes.
Microsoft .NET Framework 4.7.1 or higher
If needed, the installer may be downloaded here.
Windows Communication Foundation HTTP Activation
To enable it:
- Click the "Start" button, and then "Control Panel".
- Click "Programs", and then "Programs and Features".
- On the "Tasks" menu, click "Turn Windows features on or off".
- Find the ".NET Framework..." node and expand it.
- Check the "Windows Communication Foundation HTTP Activation" option.
Microsoft Internet Information Services (IIS) with HTTPS service
IIS 7.0 or higher is required.
GeneXus Server uses HTTPS to ensure a proper level of security. HTTPS is a protocol for secure communication over HTTP with a connection encrypted by Transport Layer Security (TLS) or Secure Sockets Layer (SSL) for the authentication of websites, and to protect the privacy and integrity of data exchanged.
Please refer to this document on how to install a certificate and setup HTTPS for IIS.
IIS URL Rewrite Module
This module is used by GeneXus Server to implement friendly URLs. Check the details on how to install it.
Microsoft SQL Server
SQL Server 2008 R2 or later is required. Any edition (eg: Express, Standard, etc.) is supported.
For better performance, using a local SQL Server (installed on the same server) is highly recommended.
GeneXus Server Setup will request the identity of this SQL Server and the credentials for it. The database user must either be an administrator or have the "sysadmin" property enabled.
Microsoft SQL Server Command Line Utilities
Both utilities are normally installed together with SQL Server. However, when using a remote SQL Server, you will need to install these components. They may be downloaded from the following locations, according to the SQL Server version:
SQL Server 2016: Microsoft Command Line Utilities 13 for SQL Server
SQL Server 2014: Microsoft Command Line Utilities 11 for SQL Server
SQL Server 2012: Microsoft SQL Serve 2012 Command Line Utilities
SQL Server 2008 R2: Microsoft SQL Server 2008 R2 Command Line Utilities
Note: If they are not installed in the default location, you may need to add the following entry to the config file at <GeneXus Server Install Path>\VDir\web.config
<add key="bcpPath" value="full path to bcp.exe">
The full path to bcp.exe is usually similar to "C:\Program Files\Microsoft SQL Server\<SQL_version>\Tools\Binn"
GeneXus Server may be installed several times using different Virtual Directories. Make sure each application pool associated with the GeneXus Server installation uses the same Windows user to share the same local license. See GeneXus Server multi-instance installation for more details.
A client machine interacting with a GeneXus Server requires:
For browsing purposes only (GeneXus Server Console) one of the following browsers is required:
- Internet Explorer 10 or higher
- Firefox 45.0 or higher
- Chrome 48.0 or higher
For interaction through GeneXus Server services (using GeneXus IDE or MSBuild tasks):