Install LabKey Server (Windows Graphical Installer)

This topic gives a step-by-step explanation of the Windows Graphical Installer wizard.

Note that the graphical installer is intended for single-machine, PostgreSQL-based installations on English-language versions of Windows, primarily for evaluation purposes. For other types of installations and more information, see Install LabKey.

For a list of which components will be installed on your computer, see Installation Basics.

Steps to Install LabKey Server

  1. Register with LabKey, then download and run the Windows installer: {}
  2. On the Installation Type page, select LabKey Server (Standard Installation).
  3. Indicate that you understand that when you install LabKey, your computer becomes a web server and a database server.
  4. Accept the license agreement.
  5. Decide whether to install MSFileReader libraries. These libraries are used for mass spectrometry applications, specifically to convert MS/MS files to the mzXML format. For details see RAW to mzXML Converters.
  6. Provide connection information for an outgoing SMTP mail server. (You can change these settings after installation is complete.)
  7. Provide a user name and password for the database superuser for PostgreSQL, the database server which is installed by the installer. In PostgreSQL, a superuser is a user who is allowed all rights, in all databases, including the right to create users. You can provide the account information for an existing superuser, or create a new one. You may want to write down the user name and password you provide.
  8. Specify the directory location for the LabKey Server installation.

Setting Up Your Account

At the end of the installation process, the LabKey installer will automatically launch your default web browser and launch LabKey if you have left checked the default option Open browser to LabKey Server. Otherwise, open your web browser and navigate to http://localhost:8080/labkey.

Once you launch LabKey, you'll be prompted to set up an account by entering your email address and a password. You are now the first site administrator for this LabKey installation.


LabKey will install all modules and then give you the choice of customizing the installation by setting properties for the LabKey application.

Installer Troubleshooting

Note that the LabKey installer installs PostgreSQL on your computer. You can only have one PostgreSQL installation on your computer at a time, so if you have an existing installation, the LabKey installer will fail. Try uninstalling PostgreSQL, or if you want to use your existing PostgreSQL installation, perform a manual installation of LabKey instead.

Additional help can be found in Troubleshoot Installation.

After Installation

After installation, you may also find it helpful to tune PostgreSQL for performance and further customize your installation.

Securing the LabKey Configuration File

Important: The LabKey configuration file contains user name and password information for your database server, mail server, and network share. For this reason you should secure this file within the file system, so that only designated network administrators can view or change this file. For more information on this file, see labkey.xml Configuration File.


expand all collapse all