Public | Automated Build

Last pushed: 5 months ago
Short Description
ImmuneDB frontend
Full Description



This repository contains the web interface to ImmuneDB. If you plan on using Docker compose, you can ignore this repository entirely and refer to the ImmuneDB documentation. This readme details how to build and run the frontend to run on bare-metal.


With node.js installed, run:

npm install

The following environment variables are used by webpack to generate content:

  • API_ENDPOINT: Full URL to the backend API
  • BASENAME (optional): Prefix after hostname to the app (e.g. for
    the value should be set to mydb)
  • SITE_TITLE (optional): A custom site title can be specified otherwise it
    will default to "ImmuneDB"
  • NODE_ENV (optional): If set to 'production', builds the package in
    production mode, reducing debug information and placing a version label on the

It is assumed that at least API_ENDPOINT is set for the remainder of this README.

Running in Docker

Docker can be used to serve the ImmuneDB frontend.

docker build -t immunedb-frontend .
docker run -p 8080:8080 -e "API_ENDPOINT=http://localhost:5000" \

This will serve the web app from http://localhost:8080 and assumes
immunedb_rest is running on localhost port 5000.

Serving with Nginx

To build static files which can be served via a web server:

NODE_ENV=production npm run build
cp -r dist /path/to/serve/from

For NGINX, add the following to your configuration:

location /path/to/frontend {
    alias /path/to/serve/from;
    index index.html;
    try_files $uri $uri/ /path/to/frontend/index.html;

Development Server

To serve content for development purposes only, run:

npm run serve
Docker Pull Command
Source Repository