Running On-Premise

Run the Universal Data Tool on your infrastructure.

For small companies or projects, you might want to consider just using the Desktop Application or, which requires less setup!

The Universal Data Tool can be run and customized on your own infrastructure easily. This is best for users who want to keep their version of Universal Data Tool stable, and don't need new features from weekly releases. You may also want to keep your data within your network.

Run via Docker

The Universal Data Tool builds docker containers on every new release. You can run the Universal Data Tool using...

# Starts the Universal Data Tool on port 3000 and a collaborative server on 3001
docker run -d -p 3000:3000 -p 3001:3001 \
             -e UDT_collaborationServer_url=http://localhost:3001 \

You can provide different options to the docker container to control various aspects of Universal Data Tool. Below is a table of a few of the configuration parameters can customize. You'll know if a configuration value is used because it will appear in the starting logs like the following image...

Environment Var



Collaboration server URL


Comma-delimited URLs to plugins that should be loaded by default


Proxy to use for CORS requests, e.g. to make api requests that are disallowed by CORs


Access Key for uploading/importing from AWS S3 buckets


Secret Access Key for uploading/importing from AWS S3 buckets


Region of S3 Bucket


Cognito Identity Pool Id


Cognito Region


Cognito user pool id


Cognito user pool web client id


Bucket to use for Cognito object storage


Region of bucket to use for Cognito


Disable remote paid collaboration requests


API Key for requesting work from Label Help

These are the most common configuration values, but you can also customize hotkeys or any other attribute the appears in the AppConfig.

Independent Collaboration Server

Sometimes, you may want to run the Collaboration Server on a different machine than the Client Application, you can do this by using the npm module.

# via npm
npm install -g udt-collaboration-server

udt-collaboration-server --port 3001

Last updated