You are given four unique options for downloading your output files for each completed analysis. These options have certain benefits and limitations that make them appropriate for different circumstances, as explained in the table below.

Web browser
• The easiest option for many users
• Unreliable for large files
• Limited to one file at a time
10x Genomics Cloud CLI
• Reliable for large files
• Requires installation and use of the 10x Genomics Cloud CLI
curl
• Reliable for large files
• No external software required
wget
• Mostly reliable for large files
• No external software required
• Less reliable than 10x Genomics Cloud CLI and curl

This button will be temporarily disabled when multiple files or folders are selected.

Any number of output files and entire output directories can be downloaded through the CLI options. After selecting one or more output files or folders, you can generate commands for your downloads using a CLI by clicking on the CLI Download button.

The recommended CLI download method is using the 10x Genomics Cloud CLI. This tab will contain a txg command that you can copy and paste into your terminal, and this download method provides advanced features that are not contained in the alternative download options.

If you prefer to use curl or wget, or if you are downloading on a machine that does not have the 10x Genomics Cloud CLI installed, these options are available on the CLI download dialog.

The 10x Genomics Cloud CLI is a command line tool that allows you to download output files, upload custom references and FASTQ files to your 10x Genomics account, create projects from the command line, and manage other tasks related to your 10x Genomics account.

It is an executable that can be run directly and requires no compilation or installation.

Below is a step-by-step video guide which demonstrates how to install and run commands in the 10x Genomics Cloud CLI for macOS operating systems. Linux users will find the installation and usage instructions nearly identical to macOS users.

Download the 10x Genomics Cloud CLI for your operating system and unpack it to a convenient location. Make sure you download the 10x Genomics Cloud CLI for the operating system where your data lives. Your home directory is a good default location.

Optionally, install the binary in a location where you can execute it globally (e.g., /usr/local/bin).

If you’re using a Linux system, use the command below to download:

curl -f -o txg-linux-v1.3.0.tar.gz https://cf.10xgenomics.com/cloud-cli/v1.3.0/txg-linux-v1.3.0.tar.gz


and then to unpack:

tar -zxvf txg-linux-v1.3.0.tar.gz


To execute commands, navigate to the 10x Genomics Cloud CLI directory in your command line application, then copy and paste the command that is provided to you in the download dialog in Cloud Analysis. An example is provided below:

./txg analyses download Qd99qUXk4ThupsFmtsOh7PA --file-id Zcc2qNy99R5Ge1R4995lLapQ


After verifying your identity, you will be able to download files with the download command provided in Cloud Analysis. All the files will be saved to the same directory where the 10x Genomics Cloud CLI is located. Alternatively, you may specify a download location of your choice using the optional --target-dir command.

You are about to download the following 1 file(s):

Analysis name: "Test Analysis"
Number of files: 1
Destination: /Users/user.name/txg-macos-v1.3.0/test_analysis

config.csv (669 B)

Total Size: 669 B.

You have 6.08 GB of free output downloads remaining for this analysis.
Proceed? [y/N]


After pressing 'y' to proceed with the download, you will see a success message:

Starting download...

config.csv (669 B) Done


Below is a step-by-step video guide which demonstrates how to install and run commands on the 10x Genomics Cloud CLI for macOS operating systems.

Download the 10x Genomics Cloud CLI for your operating system and unpack it to a convenient location. Make sure you download the 10x Genomics Cloud CLI for the operating system where your data lives. Your home directory is a good default location.

Optionally, install the binary in a location where you can execute it globally (e.g., /usr/local/bin).

If you’re using a macOS system, open the Terminal app and use the command below to download:

curl -f -o txg-macos-v1.3.0.zip https://cf.10xgenomics.com/cloud-cli/v1.3.0/txg-macos-v1.3.0.zip


and then to unpack:

unzip txg-macos-v1.3.0.zip


To execute commands, navigate to the 10x Genomics Cloud CLI directory in your Terminal app, then copy and paste the command that is provided to you in the download dialog in Cloud Analysis. An example is provided below:

./txg analyses download Qd99qUXk4ThupsFmtsOh7PA --file-id Zcc2qNy99R5Ge1R4995lLapQ


After verifying your identity, you will be able to download files with the download command provided in Cloud Analysis. All the files will be saved to the same directory where the 10x Genomics Cloud CLI is located. Alternatively, you may specify a download location of your choice using the optional --target-dir command.

You are about to download the following 1 file(s):

Analysis name: "Test Analysis"
Number of files: 1
Destination: /Users/user.name/txg-macos-v1.3.0/test_analysis

config.csv (669 B)

Total Size: 669 B.

You have 6.08 GB of free output downloads remaining for this analysis.
Proceed? [y/N]


After pressing 'y' to proceed with the download, you will see a success message:

Starting download...

config.csv (669 B) Done


Below is a step-by-step video guide which demonstrates how to install and run commands in the 10x Genomics Cloud CLI for Windows operating systems.

Download the 10x Genomics Cloud CLI for your operating system and unpack it to a convenient location. Make sure you download the 10x Genomics Cloud CLI for the operating system where your data lives. Your Documents folder is a good default location.

Optionally, install the binary in a location where you can execute it globally (e.g., /usr/local/bin).

10x Genomics Cloud CLI for Windows v1.3.0

Alternatively, open the Command Prompt (cmd.exe) and use the command below to download:

curl -f -o txg-windows-v1.3.0.zip https://cf.10xgenomics.com/cloud-cli/v1.3.0/txg-windows-v1.3.0.zip


To execute commands, navigate to the 10x Genomics Cloud CLI directory in your Command Prompt, then copy and paste the command that is provided to you in the download dialog in Cloud Analysis. An example is provided below:

txg.exe analyses download Qd99qUXk4ThupsFmtsOh7PA --file-id Zcc2qNy99R5Ge1R4995lLapQ


After verifying your identity, you will be able to download files with the download command provided in Cloud Analysis. All the files will be saved to the same directory where the 10x Genomics Cloud CLI is located. Alternatively, you may specify a download location of your choice using the optional --target-dir command.

You are about to download the following 1 file(s):

Analysis name: "Test Analysis"
Number of files: 1
Destination: /Users/user.name/txg-macos-v1.3.0/test_analysis

config.csv (669 B)

Total Size: 669 B.

You have 6.08 GB of free output downloads remaining for this analysis.

Starting download...