The installation script for DRAGEN TruSight Oncology 500 Analysis Software installs the following software and dependencies:
DRAGEN TruSight Oncology 500 Analysis Software itself
DRAGEN Software if a compatible version is not present
Docker software if a compatible version is not present
A script required to generate DRAGEN genome hash table
A script to check that DRAGEN TruSight Oncology 500 Analysis Software is installed properly
DRAGEN server v3 or v4
Network-attached storage (NAS) with enabled mkfifo if performing analysis for the TruSight Oncology 500 High-Throughput assay
The following software is required to successfully install DRAGEN TSO 500 v2.5.3:
Linux CentOS 7.9 operating system (or later) or Oracle Linux 8 (or later), one of which is provided on the server. Oracle Linux 8 is recommended.
Docker Software, see table below for minimum version needed. If sufficient Docker software is not present on the server, the TSO 500 installer will install compatible Docker software.
DRAGEN Server Software, see table below for minimum version needed as the host version on the server. If sufficient DRAGEN software is not present on the server, the TSO 500 installer will install compatible DRAGEN software.
TSOCombined license
TSO500_HRD license (to analyze data generated with the TSO 500 HRD add-on kit)
TSOCombined license has been pre-installed to DRAGEN servers in manufacturing since August 2022 and TSO500_HRD since February 2025 and additionally distributed to DRAGEN servers connected online. To generate a list of installed DRAGEN server licenses, run the following command: /opt/edico/bin/dragen_lic. If a license is not installed, contact Illumina Customer Care at for the license.
Illumina recommends logging in as root user for installation, but as a non-root user for running TSO 500 analysis.
A non-root user must be a member of the Docker group to run Docker. For more information on Docker permission requirements and alternatives to running as root, refer to the Docker documentation available on the .
Installing and uninstalling DRAGEN TruSight Oncology 500 Analysis Software and running the system check requires root privileges.
Run DRAGEN TruSight Oncology 500 Analysis Software without being logged in as a root user. Running the DRAGEN TruSight Oncology 500 Analysis Software as root is not required or recommended.
DRAGEN TSO 500 Analysis Software v2.5.3 is single-version compatible. It does not include multi-version compatibility that refers to ability to be installed on a single DRAGEN server with software running a different version of DRAGEN software. For example, multi-version compatible pipelines running DRAGEN v4.3.6 can be co-installed on a server alongside DRAGEN TSO 500 pipelines running DRAGEN v3.10.17. For more details on DRAGEN multi-version compatibility, please visit .
Compatibility of software for co-installation with DRAGEN TSO 500 v2.5.3 on a DRAGEN server is summarized in the table below:
*Install DRAGEN TSO 500 Analysis Software v2.6.0 after installing 2.5.3. If v2.5.3 is installed after v2.6.0, re-execute the installation script for v2.6.0 to install the compatible version of DRAGEN Software without impacting v2.5.3.
** When co-installing v2.5.3 with DRAGEN TSO 500 ctDNA software on the same DRAGEN server, install the software with the highest corresponding DRAGEN Software version last. Find DRAGEN software versions for DRAGEN TSO 500 ctDNA software in parentheses: v2.1.1 (v3.10.9), v2.5.0 (v3.10.15), 2.6.0 (v3.10.17), 2.6.1 (v3.10.18).
***For example, DRAGEN Enrichment, DRAGEN Germline, and others
As a root user, perform the following steps to install DRAGEN TSO 500 v2.5.3 Analysis Software:
Contact Illumina Customer Care at to obtain the DRAGEN TSO 500 Analysis Software installer package.
Download the installation package provided in the email from Illumina. The link expires after 7 days.
It is recommended to use a command line tool like wget or curl to download the file rather than pasting the link into the web browser bar. For example:
curl -o {filename} "{link}"
wget -O {filename} '{link}'
Where the file name is the installation script file name, and the link is provided by Illumina Customer Care.
Make sure no other analysis is being performed. Installing the software while performing other analyses prevent the installer process from proceeding
Copy the install script to the /staging directory to store the script in the directory.
Installation Script: install_DRAGEN_TSO500-2.5.3.run
MD5sum: sha256:ab9fae7ba58842d797ba689e702693c0fd7a5c2852dda610dce6d68152fe1f8d
Use the following command to update the run script permission:
chmod +x /staging/install_DRAGEN_TSO500-2.5.3.run
Use the following command to run the installation script (run time ~ 20 mins):
For Docker, use the following command:
sudo TMPDIR=/staging /staging/install_DRAGEN_TSO500-2.5.3.run. The script installs compatible DRAGEN software and removes any previously installed versions.
Review license requirements, how to check which licenses are installed and how to receive a license in . Licenses can be installed before or after DRAGEN TSO 500 software installation.
To install a license (TSOCombined and/or TSO500_HRD) on a DRAGEN server connected to the internet:
Confirm that the server is connected to the Internet, example: ping www.illumina.com
Run the following command: /opt/edico/bin/dragen_lic -i auto
To install a license (TSOCombined and/or TSO500_HRD) on a DRAGEN server not connected to the internet:
Contact Customer Care at to request a license file for each of the needed licenses
Download and save the license file(s) to a location that is accessible from the DRAGEN server
For each license file, run the command, where <license file received> is the absolute path to the license file: sudo /opt/edico/bin/dragen_lic -i /tmp/<license file received>.bin
To check the success of license installation, run: /opt/edico/bin/dragen_lic. Installed licenses should be in the list.
After installation is complete, make sure the system functions properly by running the following command: /usr/local/bin/check_DRAGEN_TSO500-2.5.3.sh
The script checks that:
All required services are running
Proper Docker image is installed
DRAGEN TSO 500 Analysis Software can successfully process a test data set
The system check script runs for approximately 25 minutes. If the script prints a failure message, contact Illumina Technical Support and provide the /staging/check_DRAGEN_TSO500_<timestamp>.tgz output file.
If using MacOS to connect to a server, an error can occur if the local settings are not in English. To resolve the error, disable the ability to set environment variables automatically in Terminal settings.
The DRAGEN TruSight Oncology 500 Analysis Software installation includes an uninstall script called uninstall_DRAGEN_TSO500-2.5.3.sh, which is located in /usr/local/bin.
Executing the uninstall script removes the following assets:
All DRAGEN TruSight Oncology 500 Analysis Software related scripts located in /usr/local/bin
Resources found in /staging/illumina/DRAGEN_TSO500
The dragen_tso500:2.5.3: Docker image
To uninstall the DRAGEN TSO 500 Analysis Software, run the following command as a root user:
uninstall_DRAGEN_TSO500-2.5.3.sh
You are not required to uninstall Docker or DRAGEN software. To remove Docker, review the install instructions for your operating system in the Docker documentation.
DRAGEN TSO 500
2.6.1+
Multi-version
No
DRAGEN TSO 500 ctDNA
1.2 or below
Single-version
No
DRAGEN TSO 500 ctDNA
2.1.1, 2.5.0, 2.6.0, 2.6.1
Single-version
Yes**
DRAGEN TSO 500 ctDNA
2.6.2+
Multi-version
No
DRAGEN pipelines***
3.10.16
Single-version
Yes
DRAGEN pipelines***
Any version except 3.10.16
Single- or multi-version
No
For Apptainer, use the following command:
sudo TMPDIR=/staging /staging/install_DRAGEN_TSO500-2.5.3.run -- --noDockerInstall This will not install Apptainer, but will install the analysis software in the SIF container format and modify the software to launch analyses using Apptainer.
During the installation process, you might be instructed to reboot or power cycle the system to complete the installation of the DRAGEN software. A power cycle of the system requires the server be shut down and restarted.
Log out of the server and then log back in.
Use the following command to build the DRAGEN server hash table, which runs for approximately 60 minutes:
/usr/local/bin/build-hashtable_DRAGEN_TSO500-2.5.3.sh
Refer to Troubleshooting if any errors occur.
Docker
20.10 or greater
Docker 20.10.15
DRAGEN Software
v3.10.x where x is 16 or greater
DRAGEN Software 3.10.16
DRAGEN TSO 500
2.5.2 or below
Single-version
No
DRAGEN TSO 500
2.5.4
Multi-version
No
DRAGEN TSO 500
2.6.0
Single-version
Yes*
Illumina Connected Analytics (ICA) subscription includes access to DRAGEN TruSight Oncology 500 Analysis Software. To get started, you need:
An ICA account with a valid subscription. Refer to the Software Registration page for information on how to register ICA subscription and iCredits.
A positive balance of iCredits for data storage. Please refer to the and for more information.
The table provides guidance on the storage needs and associated ICA storage size settings.
NovaSeq 6000/6000Dx (RUO) S4 Flow Cell
4,300
Large
NovaSeq X 1.5B
2,000
Large
NovaSeq X 10B
4,300
Large
NovaSeq X 25B
8,400
XLarge
NextSeq 1000/2000
350
Large
NextSeq 500/550/550Dx (RUO) HO flow cell
350
Large
NovaSeq 6000/6000Dx (RUO) SP Flow Cell
500
Large
NovaSeq 6000/6000Dx (RUO) S1 Flow Cell
1100
Large
NovaSeq 6000/6000Dx (RUO) S2 Flow Cell
2,500
Large
The installation script for DRAGEN TruSight Oncology 500 Analysis Software installs the following software and dependencies:
DRAGEN TruSight Oncology 500 Analysis Software itself
DRAGEN Software if a compatible version is not present
Docker software if a compatible version is not present
A script required to generate DRAGEN genome hash table
A script to check that DRAGEN TruSight Oncology 500 Analysis Software is installed properly
DRAGEN server v3 or v4
Network-attached storage (NAS) with enabled mkfifo if performing analysis for the TruSight Oncology 500 High-Throughput assay
The following software is required to successfully install DRAGEN TSO 500 v2.5.4:
Linux CentOS 7.9 operating system (or later) or Oracle Linux 8 (or later), one of which is provided on the server. Oracle Linux 8 is recommended.
Docker Software, see table below for minimum version needed. If sufficient Docker software is not present on the server, the TSO 500 installer will install compatible Docker software.
DRAGEN Server Software*, see table below for minimum version needed as the host version on the server. If sufficient DRAGEN software is not present on the server, the TSO 500 installer will install compatible DRAGEN software.
*The DRAGEN Server Software version may be higher than the DRAGEN version used by the DRAGEN TSO 500 v2.5.4 pipeline (DRAGEN v3.10.16), which is provided inside the DRAGEN TSO 500 docker image.
TSOCombined license
TSO500_HRD license (to analyze data generated with the TSO 500 HRD add-on kit)
TSOCombined license has been pre-installed to DRAGEN servers in manufacturing since August 2022 and TSO500_HRD since February 2025 and additionally distributed to DRAGEN servers connected online. To generate a list of installed DRAGEN server licenses, run the following command: /opt/edico/bin/dragen_lic. If a license is not installed, contact Illumina Customer Care at for the license.
Illumina recommends logging in as root user for installation, but as a non-root user for running TSO 500 analysis.
A non-root user must be a member of the Docker group to run Docker. For more information on Docker permission requirements and alternatives to running as root, refer to the Docker documentation available on the .
Installing and uninstalling DRAGEN TruSight Oncology 500 Analysis Software and running the system check requires root privileges.
Run DRAGEN TruSight Oncology 500 Analysis Software without being logged in as a root user. Running the DRAGEN TruSight Oncology 500 Analysis Software as root is not required or recommended.
DRAGEN TSO 500 Analysis Software v2.5.4 is multi-version compatible. Multi-version compatibility refers to ability to be installed on a single DRAGEN server with software running a different version of DRAGEN software. For example, multi-version compatible pipelines running DRAGEN v4.3.6 can be co-installed on a server alongside DRAGEN TSO 500 pipelines running DRAGEN v3.10.17. For more details on DRAGEN multi-version compatibility, please visit .
Software versions without multi-version compatibility referred to as single-version compatible. DRAGEN TSO 500 Analysis Software v2.5.4 will disrupt installations of single-version compatible software from the DRAGEN server. To uninstall a previous version of DRAGEN TSO 500 Analysis Software, refer to the respective guide.
Compatibility of software for co-installation with DRAGEN TSO 500 v2.5.4 on a DRAGEN server is summarized in the table below:
*DRAGEN TSO 500 Analysis Software v2.5.4 can run on a single server with another multi-version compatible DRAGEN TSO 500 Analysis Software, e.g. DRAGEN TSO 500 v2.6.1, and should be installed before v2.6.1. DRAGEN TSO 500 Analysis Software v2.5.4 can be co-installed with multi-version compatible DRAGEN TSO 500 ctDNA Analysis Software or other DRAGEN pipelines with any order of installation.
**For example, DRAGEN Enrichment, DRAGEN Germline, DRAGEN WGS Heme v1.0.0 and others. Order of installation does not matter.
As a root user, perform the following steps to install DRAGEN TruSight Oncology 500 Analysis Software v2.5.4:
Contact Illumina Customer Care at to obtain the DRAGEN TruSight Oncology 500 Analysis Software installer package.
Download the installation package provided in the email from Illumina. The link expires after 7 days.
It is recommended to use a command line tool like wget or curl to download the file rather than pasting the link into the web browser bar. For example:
curl -o {filename} "{link}"
wget -O {filename} '{link}'
Where the file name is the installation script file name, and the link is provided by Illumina Customer Care.
Make sure no other analysis is being performed. Installing the software while performing other analyses prevent the installer process from proceeding
Copy the install script to the /staging directory to store the script in the directory.
Installation Script: install_DRAGEN_TSO500-2.5.4.run
MD5sum: sha256:0d871d8b93b4e535c0c1b5614c180fdb815f80764274279881c8a25a4e153160
Use the following command to update the run script permission:
chmod +x /staging/install_DRAGEN_TSO500-2.5.4.run
Use the following command to run the installation script (run time ~ 20 mins):
For Docker, use the following command:
sudo TMPDIR=/staging /staging/install_DRAGEN_TSO500-2.5.4.run. The script installs compatible DRAGEN software and removes any previously installed versions.
Review license requirements, how to check which licenses are installed and how to receive a license in . Licenses can be installed before or after DRAGEN TSO 500 software installation.
To install a license (TSOCombined and/or TSO500_HRD) on a DRAGEN server connected to the internet:
Confirm that the server is connected to the Internet, example: ping www.illumina.com
Run the following command: /usr/bin/dragen_lic -i auto
To install a license (TSOCombined and/or TSO500_HRD) on a DRAGEN server not connected to the internet:
Contact Customer Care at to request a license file for each of the needed licenses
Download and save the license file(s) to a location that is accessible from the DRAGEN server
For each license file, run the command, where <license file received> is the absolute path to the license file: sudo /usr/bin/dragen_lic -i /tmp/<license file received>.bin
To check the success of license installation, run: /usr/bin/dragen_lic. Installed licenses should be in the list.
After installation is complete, make sure the system functions properly by running the following command: /usr/local/bin/check_DRAGEN_TSO500-2.5.4.sh
The script checks that:
All required services are running
Proper Docker image is installed
DRAGEN TSO 500 Analysis Software can successfully process a test data set
The system check script runs for approximately 25 minutes. If the script prints a failure message, contact Illumina Technical Support and provide the /staging/check_DRAGEN_TSO500_<timestamp>.tgz output file.
If using MacOS to connect to a server, an error can occur if the local settings are not in English. To resolve the error, disable the ability to set environment variables automatically in Terminal settings.
The DRAGEN TSO 500 Analysis Software installation includes an uninstall script called uninstall_DRAGEN_TSO500-2.5.4.sh, which is located in /usr/local/bin.
Executing the uninstall script removes the following assets:
All DRAGEN TSO 500 Analysis Software related scripts located in /usr/local/bin
Resources found in /staging/illumina/DRAGEN_TSO500
The dragen_tso500:2.5.4: Docker image
To uninstall the DRAGEN TSO 500 Analysis Software, run the following command as a root user:
uninstall_DRAGEN_TSO500-2.5.4.sh
You are not required to uninstall Docker or DRAGEN software. To remove Docker, review the install instructions for your operating system in the Docker documentation.
DRAGEN TSO 500 ctDNA
2.6.2+
Multi-version
Yes
DRAGEN TSO 500 ctDNA
2.6.1 or below
Single-version
No
DRAGEN pipelines**
4.3.6+
Multi-version
Yes
DRAGEN pipelines**
4.2 or below
Single-version
No
For Apptainer, use the following command:
sudo TMPDIR=/staging /staging/install_DRAGEN_TSO500-2.5.4.run -- --noDockerInstall This will not install Apptainer, but will install the analysis software in the SIF container format and modify the software to launch analyses using Apptainer.
During the installation process, you might be instructed to reboot or power cycle the system to complete the installation of the DRAGEN software. A power cycle of the system requires the server be shut down and restarted.
Log out of the server and then log back in.
Use the following command to build the DRAGEN server hash table (run time ~ 1 hr):
/usr/local/bin/build-hashtable_DRAGEN_TSO500-2.5.4.sh
Refer to Troubleshooting if any errors occur.
Docker
20.10 or greater
Docker 20.10.15
DRAGEN Server Software*
v3.10.x, where x >=19, v4.3+
DRAGEN Software 3.10.19
DRAGEN TSO 500
2.6.1
Multi-version
Yes*
DRAGEN TSO 500
2.6.0
Single-version
No
DRAGEN TSO 500
2.5.3 or below
Single-version
No