FbF bioServer + App Server install requirements

logo.bmp

v1.3.2 (09/18/2026)

CheckList

1. Install VC++ 14 x64

https://aka.ms/vc14/vc_redist.x64.exe

2. Install Microsoft .NET 4.8

On operating systems such as Windows Server 2022, .NET 4.8 is installed as a Server Feature. In your Server Manager > Features, install the following features:

If prompted for additional features (dependencies), accept.

On other operating systems, .NET 4.8 must be downloaded and installed separately using an installer. The installer can be downloaded here https://dotnet.microsoft.com/en-us/download/dotnet-framework/thank-you/net48-web-installer

3. Install IIS

3.1 Enable the Web Server (IIS) role

Requirements: IIS must be installed. On Windows Server 2022 and 2025, this requires installing the "Web Server (IIS)" server role with the following features:

3.2 Install and configure Application Request Routing (FbF AppServer only)

In the following order:

Note: If IIS was launched before installing Url Rewrite and ARR, make sure to close it and restart it. Otherwise, ARR won't be available in IIS.

4. Ensure availability of a database Server

FbF AppServer and bioServer support both Microsoft SQL Server and PostgreSQL. The installer will allow you to select the target database engine. In either case, the database server must be available and a suitable database must be provisioned first.

4.1 SQL Server

4.1.1 Install SQL Server

In the absence of a dedicated database server, it is possible to self-host an instance of SQL Server 2022 on the same VM as the solution.

Documentation on how to install SQL Server is widely available online. We recommend enabling Mixed Mode authentication, as it will allow both Windows Authentication (without needing to input credentials in the various connection strings) and SQL authentication (credentials need to be present in the connection strings, but overall management is more simple).

Important:

To ensure the above points are properly configured, launch the SQL Server 2022 Configuration Manager app from the startup menu as an administrator.

4.1.2 Install SQL Server Management Studio

In addition to SQL Server, the install process will require executing several SQL scripts on the DB server. To do so, we recommend the use of SQL Server Management Studio (SSMS). It can be downloaded here https://learn.microsoft.com/en-us/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-ver16.

Documentation on how to install SQL Server is widely available online.

4.1.3 Install Microsoft ODBC Driver 18 for SQL Server

The steps below are only necessary in the following cases:

Download and install Microsoft ODBC Driver 18 for SQL Server, using the default options.

To install and configure your ODBC data source:

4.2 PostgreSQL

4.2.1. Install PostgreSQL

In the absence of a dedicated database server, it is possible to self-host an instance of PostgreSQL on the same VM as the solution.

Documentation on how to install PostgreSQL is widely available online.

4.2.2. Install pg Admin

PgAdmin is bundled in the PostgreSQL installer. You can also download it and install separately using the following link: https://www.pgadmin.org/download/.

4.2.3 Install the PostgreSQL ANSI (x64) ODBC Driver

The steps below are only necessary in the following cases:

Download and install PostgreSQL ANSI (x64) ODBC driver. In particular, download the Windows x64 version: psqlodbc_x64.msi.

To install and configure your ODBC data source:

5. Initialize the databases

5.1 bioServer DB

Optionally, you may create a SQL user specifically for this application. To do so, you can execute the script db-user.sql (The script is included in the bioServer installer archive). Before doing so, edit the file with a text editor and ensure:

SQL Server only: If opting for Windows credentials, execute the script db-user-windows.sql on the database. Before doing so, edit the file with a text editor and ensure:

5.2 AppServer DB

You may create a SQL user specifically for this application. To do so, you can execute the script backend/db/mssql/mssql-user-init.sql or backend/db/postgres/postgres-user-init.sql (The script is included in the AppServer installer archive). Before doing so, edit the file with a text editor and ensure the database, username and password are set accordingly. Similarly to the FbF bioServer install, you can use a Windows user script instead: backend/db/mssql/mssql-user-init-windows.sql (SQL Server only).

6. Firewall rules

Appendix A: Specs

Target population: 200k templates

These specifications include running an instance of the database server locally on the same machine.

Target population: 1 million

These specifications do not include running an instance of the database server locally on the same machine. We recommend hosting a database on a dedicated database server.

Target population: 10 millions

These specifications do not include running an instance of the database server locally on the same machine. We recommend hosting a database on a dedicated database server.