# Troubleshooting

## Setup of development environment hangs indefinitely when running the `dev-install.py` step, specifically on the Yarn linking step.

This may be caused by having a `.gitignore` file in your home directory.
This is a [known issue with Nx](https://github.com/nrwl/nx/issues/27494).
The [only known workaround](https://github.com/nrwl/nx/issues/27494#issuecomment-2481207598)
is to remove the `.gitignore` file from your home directory or to work in a location
outside of the home directory tree.

## Every UI test fails after 60 seconds due to timeout.

This could be caused by having a JupyterLab instance already running at port `:8888`.
Please ensure that there is nothing running at <http://localhost:8888/lab> before
running tests.

## Build fails in CI with error about `.yarn-state.yml`

```
Error: ENOENT: no such file or directory, unlink '/home/runner/work/jupytergis/jupytergis/node_modules/.yarn-state.yml'
```

Re-running the job can get you past this error.