SRA Toolkit Installation Guide (2026): Windows, Linux, and macOS

In today’s era of big data, genomic information has become a cornerstone of research, offering profound insights into biology, medicine, and evolution. But, accessing the vast repositories of raw sequencing reads requires specialized tools. That’s where the SRA Toolkit comes in—a powerful suite of tools designed to unlock the wealth of publicly available sequencing data stored in the Sequence Read Archive (SRA database).

This guide provides step-by-step instructions for installing the SRA Toolkit on all major operating systems: Windows, macOS, and Linux. Whether you’re using a personal computer or a research workstation, this article will help you install and configure the toolkit correctly to ensure smooth operation. Now, let’s dive into the installation process for each operating system.

Installing the SRA Toolkit on Linux (Ubuntu, Debian, CentOS, docker)

1- Update Your System

Before starting, ensure your Linux system is up-to-date to avoid compatibility issues. Run the following commands:

sudo apt update && sudo apt upgrade -y

2- Download the SRA Toolkit

Download the last version of SRA Toolkit using the wget command.

For ubuntu:

wget https://ftp-trace.ncbi.nlm.nih.gov/sra/sdk/current/sratoolkit.current-ubuntu64.tar.gz

For CentOS:

wget https://ftp-trace.ncbi.nlm.nih.gov/sra/sdk/current/sratoolkit.current-centos_linux64.tar.gz 

Note: The toolkit is available for different Linux distributions, so make sure to select the appropriate version for your system.

3- Extract the Toolkit

After downloading the .tar.gz file, extract it using the tar command:

tar -xvzf sratoolkit.current-ubuntu64.tar.gz

Note: Replace sratoolkit.current-ubuntu64.tar.gz with the actual filename if you downloaded a different version

4- Add SRA Toolkit to Your PATH

To make the SRA Toolkit commands available globally, add the bin directory to your PATH. Here’s how:

I) Open your .bashrc file in a text editor:

nano ~/.bashrc

II) Add the following line at the end of the file:

export PATH=$PATH:/path/to/sratoolkit.x.x.x-ubuntu64/bin

Replace /path/to/sratoolkit.x.x.x-ubuntu64/bin with the actual path where you extracted the toolkit.

III) Save and exit:

Press Ctrl + O, then Enter to save.
Press Ctrl + X to exit.

IV) Save the file and reload the shell configuration:

source ~/.bashrc

5- Verify the Installation

Check if the SRA Toolkit is correctly installed by running:

vdb-config --version

6- Test the Installation

Run a simple test command to ensure the toolkit is working:

fastq-dump --help

Now, you have successfully installed and configured the SRA Toolkit on your Linux system👍. You’re now ready to download and process sequencing data from the NCBI SRA repository.

Installing the SRA Toolkit on Windows

Follow these steps to install and configure the SRA Toolkit on a Windows.

1- Download the SRA Toolkit

You can download the latest Windows version of SRA Toolkit from below button.

2- Extract the Toolkit

After downloading the sratoolkit.current-win64.zip file:

I) Navigate to the folder where the file was downloaded.

II) Right-click on the file and select Extract All or use a third-party tool like WinRAR or 7-Zip .

III)Choose a folder where you want to extract the files (Recommended: C:\sratoolkit.3.1.1-win64).

3- Add SRA Toolkit to the System PATH

To access the SRA Toolkit from the Command Prompt or PowerShell, you need to add its bin directory to the system PATH:

1.  Open the Start Menu and search for Environment Variables.
2. Click on Edit the system environment variables.
3. In the System Properties window, click on the Environment Variables button.
4. Under System variables, find and select the Path variable, then click Edit.
5. Click New and add the path to the bin directory of the extracted SRA Toolkit. For example:
   C:\sratoolkit.x.x.x-win64\bin
6. Click OK on all open windows to save the changes and then restart the system.

4- Verify the Installation

To ensure the SRA Toolkit is properly installed:

I) Open the Command Prompt (press Win + R, type cmd, and hit Enter).

II) Type the following command and press Enter:

vdb-config --version

If installed correctly, this will display the version of the SRA Toolkit.

5- Test the Installation

Verify that the toolkit is functioning by running a basic command:

fastq-dump --help

If the help menu appears, the toolkit is correctly installed.

You’ve successfully installed and configured the SRA Toolkit on Windows. You can now access and process data from NCBI’s SRA repository.

Troubleshooting Common Issues

1. Error: Command Not Recognized

Ensure the bin directory of the SRA Toolkit is correctly added to the PATH. Verify with:

echo %PATH%

Restart the Command Prompt or your system after modifying the environment variables.

2. SSL Connection Issues

vdb-config -i

Update the network and SSL settings as required.

Installing the SRA Toolkit on macOS

Follow these step-by-step instructions to download, install, and configure the SRA Toolkit on macOS:

1. Download the SRA Toolkit

You can download the latest Mac OS version of SRA Toolkit from below button.

2. Extract the Downloaded File

I) By default, the downloaded file will be in the Downloads folder.

II) Open the Terminal and navigate to the Downloads directory:

cd ~/Downloads

III) Extract the .tar.gz file using the tar command:

tar -xvf sratoolkit.x.x.x-mac64.tar.gz

Note: Replace sratoolkit.x.x.x-mac64.tar.gz with the actual filename if you downloaded a different version

IV)This will create a new folder, such as sratoolkit.x.x.x-mac64, in the Downloads directory.

3. Move the Toolkit to a Permanent Location

To make the toolkit accessible system-wide:

1) Move the extracted folder to a permanent location like /usr/local:

sudo mv sratoolkit.x.x.x-mac64 /usr/local/sratoolkit

II) Provide your password when prompted.

4. Add SRA Toolkit to the System PATH

To use the SRA Toolkit commands globally:

I) Open the Terminal and edit the shell configuration file based on your shell type:

nano ~/.zshrc #For zsh (default on macOS Catalina and later) nano ~/.bash_profile #For bash

II) Add the following line to the file:

export PATH=/usr/local/sratoolkit/bin:$PATH

III) Save and exit:

•  Press Ctrl + O, then Enter to save.
• Press Ctrl + X to exit.

IV) Apply the changes:

source ~/.zshrc #For zsh (default on macOS Catalina and later) source ~/.bash_profile #For bash

5. Verify Installation

I) Open a new Terminal window.

II) Run the following command to verify the installation:

vdb-config --version

Note: This should display the SRA Toolkit version number, confirming it’s installed correctly.

6. Test the SRA Toolkit

I) Try downloading an SRA sample to verify the installation:

prefetch SRR390728

II) Convert the downloaded data to FASTQ format:

fasterq-dump SRR390728

Troubleshooting Common Issues

• PATH Changes Not Applied

If the commands don’t work globally:
I) Double-check the PATH by running:

echo %PATH%

II) Ensure /usr/local/sratoolkit/bin is listed.

• Permission Issues

If you encounter permission errors during installation or execution:

I) Ensure you used sudo for commands requiring administrative access.

II) Verify folder permissions:

ls -ld /usr/local/sratoolkit

Congratulations! You’ve successfully installed the SRA Toolkit on macOS. Now, you can use the toolkit to access and process data from NCBI’s SRA repository seamlessly.

Have Questions? We’re Here to Help!

If you have any questions about installing or using the SRA Toolkit, feel free to leave a comment below. We’re always happy to assist and provide further guidance to ensure you have a smooth experience. Don’t hesitate to reach out—your feedback and queries are welcome!