enclone banner

enclone installation troubleshooting

The purpose of this page is to provide guidance in case the enclone installation fails.


Case 1: the curl command is not found

The command curl is not installed on your computer. In that case, you should have the command wget, and can use that instead. To do so, run the following command:

wget -nv bit.ly/enclone_install -O - | sh -s SIZE
where SIZE is as described on the main enclone page.


Case 2: download is so slow that it doesn't finish

In this case, please use the SMALL option, and if you still have difficulty, please contact us. We might be able to reduce the download size. Please let us know your typical download rate (MB/sec) and any other relevant information about the characteristics of your connection.


Case 3: installation seems to succeed but you get command not found

In this case, the install script appears to succeed, but when you open a new terminal window and type enclone, you get a message about the command not being found.

This should not happen, and we do not know why it happened to you, but we provide instructions here on how you can report the problem to us. Please do this and we will try to find a solution.

Please open a new terminal window, type the following commands, and then cut and paste the entirety (commands plus responses) as text into an email to enclone@10xgenomics.com.

1. enclone --check

This should say something about enclone not being found. Otherwise you have a different problem.

2. echo $PATH

This reveals what directories are searched when you type a command.

3. curl -sSf -L bit.ly/enclone_install_debug | bash

This generates some further debugging information


Case 4: installation seems to succeed but enclone is killed

In this case, when you type enclone from the command line, you'll get a message about it being killed. This has happened to some Mac users. In one case we observed that the problem went away if the executable was deleted
rm ~/bin/enclone
and then the installation line was repeated. We are actively looking for a robust solution. Please let us know if you are stuck.


Case 5: installation seems to succeed but you get a message about GLIBC not found

This probably means that you are using a Linux machine which has a very old version of the operating system on it. Your options are:

  1. Get the operating system on the machine upgraded.
  2. Use a different machine.
  3. Install enclone from source code. This is not necessarily difficult.


Case 6: something else goes wrong

Then please write to us at enclone@10xgenomics.com.