You can download a virtual machine-based instance of LabKey Server for on-site evaluation purposes.

Set Up the VM Instance

  • In VirtualBox, select File > Import Appliance. In the Virtual Machine Appliance popup dialog, browse to and select the downloaded virtual machine file. Click Next. Accept the defaults and click Import.
  • Once the VM has been added to the list, select it, and click Start > Normal Start.
  • VirtualBox will startup the server VM. (This may take a few minutes to complete.)
  • When the server VM is ready, you will see a new VirtualBox window requesting an ubuntu login. Ignore but do not close this window; you do not need to log in here.

Launch LabKey Server

  • When startup has finished, open a new web browser window or tab (such as Chrome) outside the vm. Go to the following URL location to find the LabKey Server instance running. If you do not see a server running there, wait a few more minutes for startup to complete.
  • When you first invoke the server, you will be prompted to set up an account by entering your email address and password. (This first user account created is the Site Administrator for this LabKey installation.)
  • LabKey Server is now available to use.
  • To begin, see next steps below.

Add External Users / Collaborators

If you want to add other users to your VM instance so they can explore and collaborate, you must first do the following so that the auto-generated email will direct them to the machine and port where your server is running:

  • Select (Admin) > Site > Admin Console.
  • Click Admin Console Links.
  • Under Configuration, click Site Settings.
  • Click Save. The value in this field will now be included in any invite emails that are sent out.
  • Proceed to add users.

Next Steps

  • Explore basic features using the the built-in example project:
    • Click the LabKey logo in the upper left to return to the home page of your server.
    • Click the Example Project icon.
    • Use the introductory topics here to explore the examples: Explore LabKey Server - Hosted Trial

  • The following tutorials provide step by step instructions for exploring even more key functionality:

Troubleshooting

On Windows, if you receive the following error, you need to disable Hyper-v.

VT-x is not available (VERR_VMX_NO_VMX)

To ensure that Hyper-v is disabled, click the Start menu, then type "Turn Windows features on or off". Select this option in the search results. In the popup dialog box, unselect Hyper-V and click OK. You may need to restart your host machine for the changes to take effect.

Discussion

Was this content helpful?

Log in or register an account to provide feedback


previousnext
 
expand all collapse all