enclone banner

enclone installation details

The purpose of this page is to provide some information about what the enclone installation command does, in case you're curious.

The command is:

curl -sSf -L bit.ly/enclone_install | bash -s SIZE  where SIZE is small, medium or large

1. First, bit.ly/enclone_install is a redirect to https://10xgenomics.github.io/enclone/install.sh, as you can see if you type bit.ly/enclone_install+ (the + is the way that bit.ly provides for seeing what a redirect does).

2. The -sSf option to curl causes it to run quietly if it is successful, print an error message if it fails, and importantly, not pass logging or error messages to sh.

3. The overall command just causes the script install.sh to be executed.

4. On a first invocation, the script downloads the enclone executable and datasets.

5. On subsequent invocations, the script checks to see if the local copies are current, and if not, redownloads them. In principle, the executable could be downloaded as a compressed file, which would be more efficient. For the case where SIZE is medium, the action is also inefficient, as it downloads everything if anything has changed.

6. The script puts the executable in ~/bin and the datasets in ~/enclone. These directories are created if they don't already exist.

7. The following step makes it so you don't have to type ~/bin/enclone every time you want to run it, and can instead type just enclone. To enable this, if ~/bin is not in your path, the script adds a line to .bash_profile or .profile that makes ~/bin first in your path. (Which file is used depends on the version of Linux that you're using.) If you want, when the script is done, you can manually tidy up the file to make it more readable.

Questions? You can email us at enclone@10xgenomics.com.