Get setup help
Lab Edge Relay

Connect your lab analyzers to DokiTab

Install the relay on one always-on PC in your lab. Your analyzers send results to it over the lab network, and it forwards them securely to DokiTab. If the internet drops, it keeps results on disk and sends them when the connection is back.

Checking latest build… How to set it up

  1. Analyzer Sends results to the relay PC: HL7 on port 2575, ASTM over TCP, or a serial cable
  2. Edge relay on your lab PC Saves each result to disk before confirming it, and sends the backlog when the internet is back
  3. DokiTab Results land in the lab workbench for verification and release
Early access: supervised pilot This version of the relay is in a supervised pilot and is not yet connected to a live DokiTab deployment. Contact DokiTab support before installing it: we set up the connection for your lab and watch the first results come through with you.

Choose your platform

Loading the latest build…

Set it up

  1. Pick the lab PC

    Any PC that stays on while the lab is working:

    • Windows 10/11 64-bit, or Ubuntu/Debian Linux. 2 GB RAM and 1 GB free disk for the offline backlog.
    • On the same network as the analyzers (a wired connection is more reliable than wifi), or next to a serial analyzer if it uses an RS-232 cable.
    • Give it a fixed IP address (for example 192.168.1.50) in your router, so analyzers can always find it.

  2. Get a pairing code from DokiTab support

    During the pilot, DokiTab support creates the pairing code for your lab. It looks like ABCD-2345, works once, and expires after 15 minutes, so ask for it when you are at the lab PC. No passwords or tokens to copy.

  3. Run the installer and enter the code

    Windows: extract the zip, right-click install.ps1 and choose Run with PowerShell. Enter the pairing code when asked. It installs the relay as a Windows service and opens port 2575 in Windows Firewall.

    Ubuntu / Debian:

    sudo apt install ./dokitab-edge-linux-amd64.deb
sudo dokitab-edge pair --code ABCD-2345

    Check it with dokitab-edge status, or open http://127.0.0.1:8090 on that PC for the status page.

  4. Point each analyzer at the relay

    • HL7 over TCP/IP (MLLP): in the analyzer's LIS or host settings, set the host to the relay PC's fixed IP and the port to 2575. The relay only accepts connections from private (lab network) addresses unless "allowedSources" in its config.json says otherwise.
    • ASTM over TCP: set "astmTcpPort" (for example 5000) in the relay's config.json, restart the service, and point the analyzer at that port. On Windows you can pass -AstmTcpPort 5000 to install.ps1 instead.
    • Serial (RS-232): connect the cable, then set "serial": {"port": "COM3", "baudRate": 9600} (or /dev/ttyUSB0 on Linux) to match the analyzer's settings and restart the service.

    Run one test sample and confirm it appears in the DokiTab lab workbench before going live.

Check your download

Compare the file's fingerprint with the SHA-256 shown above or in SHA256SUMS.

Releases are checksum-verified (SHA-256).

# Windows (PowerShell)
Get-FileHash .\dokitab-edge-windows-amd64.zip -Algorithm SHA256

# Linux
sha256sum dokitab-edge-linux-amd64.deb

Need a hand?

We'll help you connect your first analyzer.

Contact support
Download the relay