The GRA requires the following services to run. These services may all be hosted on the same machine or may be hosted on separate machines if desired. As an alternative to installing the GRA directly in a Web server environment, the GRA can be run from a Docker container using our official Docker images.
Web server requirements¶
Version 4 of the GRA runs in the Microsoft .NET Core 2.2 runtime environment. Downloads of the runtime environment are available from Microsoft for the following operating systems:
- macOS (10.12 “Sierra” and later versions)
- Linux (Red Hat Enterprise Linux, CentOS, Oracle Linux, Fedora, Debian, Ubuntu, Linux Mint, openSUSE, SUSE Enterprise Linux, Alpine Linux)
- Windows (x64 and x86)
As of this writing the latest release of the .NET Core 2.2 environment is Runtime v2.2.0. To host in a Windows environment you’ll need the Runtime & Hosting Bundle, for other environments you will need to install the appropriate runtime. You can safely use any 2.2.x version of the runtime (though you probably want the latest as it will incorporate security fixes).
ASP.NET Core applications can be run behind a reverse proxy or directly connected to the Internet using the built-in ASP.NET Core Kestrel Web server.
- To host with IIS, Windows Server 2008 R2 or later is supported. Note that currently GRA reporting utilizes Web Sockets and in a Windows environment that requires IIS 8 and Windows Server 2012.
- To host with Apache or Nginx, a version of Linux which supports .NET Core 2.2 should be selected (see above).
Database server requirements¶
The GRA version 4 supports the following database environments:
- Microsoft SQL Server 2008 or later using SQL Server authentication mode.
Mail server requirements¶
The ability to send Internet email, such as a service which accepts email via SMTP.
- The GRA sends mail in certain instances (such as helping users recover their lost passwords) and requires the ability to connect to an SMTP server.