Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add trouble shooting section to pip install issues with outdated pip version #278

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions docs/content/getting-started/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,21 @@ Since the Mesa driver on WSL dispatches to the Windows host graphics driver, it
For example, [line rendering issues](https://github.com/rerun-io/rerun/issues/6749) have been observed when running from WSL with an
outdated AMD driver on the Windows host.

## `pip install` issues

If you see the following when running `pip install rerun-sdk` or `pip install rerun-notebook` on a supported platform:

```sh
ERROR: Could not find a version that satisfies the requirement rerun-sdk (from versions: none)
ERROR: No matching distribution found for rerun-sdk
```

Then this is likely because you're running a version of pip that is too old.
You can check the version of pip with `pip --version`.
If you're running a version of pip 20 or older, you should upgrade it with `pip install --upgrade pip`.
⚠️ depending on your system configuration this may upgrade the pip installation aliased by `pip3` instead of `pip`.


## Startup issues

If Rerun is having trouble starting, you can try resetting its memory with:
Expand Down