Common Installation Issues

The sheet does not render when I call mitosheet.sheet().

If the sheet does not render when you call mitosheet.sheet(), this is usually fixable through the following steps:

1. Shut down the currently running JupyterLab instance. Close all browser tabs with JupyterLab open.

2. Relaunch JupyterLab. Retry calling mitosheet.sheet()

If this does not work, try rerunning the installer and repeating the above steps.

The installer hit a PermissionError during install.

If your installation fails with a PermissionError, then you likely will be able to successfully install Mito by rerunning the installation commands with adminstrator privileges.

For Windows, this means running the command prompt as an admin, and for Mac/Linux means using the sudo command for the installation commands

The installer finished successfully, but the sheet is not rendering when I follow the instructions to create a mitosheet.

This bug can be tricky to resolve. For the best chance of getting sorted, take the following steps:

1. In your browser, open the developer console. This is usually done by pressing shift+right clicking, and then clicking the option that includes the word inspect.

2. When the developer tab opens up, click the section labeled console and scroll to the top. You will likely see a red print out with some error messages.

3. Screen shot those error messages, and send them in an email to [email protected]! We'll respond within a few hours, and should be able to get your issues resolved!

I got the error ValueError: Please install Node.js and npm before continuing installation.

To resolve this:

1. Download the Node.js installer here and follow the prompts to install Node.

2. Restart your terminal.

3. Rerun the installation commands, and they should work properly.

If you have any other issues installing Mito, or you're looking to install Mito on JupyterHub or Kuberenetes, get in touch. We'd love to help.