Troubleshooting
You can set RUST_LOG=debug
before running to get some verbose logging output.
If you run into any issues don't hesitate to open a ticket or join our Discord.
Running on Linux running-on-linux
Rerun should work out-of-the-box on Mac and Windows, but on Linux you need to first run:
sudo apt-get -y install \
libclang-dev \
libatk-bridge2.0 \
libfontconfig1-dev \
libfreetype6-dev \
libglib2.0-dev \
libgtk-3-dev \
libssl-dev \
libxcb-render0-dev \
libxcb-shape0-dev \
libxcb-xfixes0-dev \
libxkbcommon-dev \
patchelf
On Fedora Rawhide you need to run:
sudo dnf install \
clang \
clang-devel \
clang-tools-extra \
libxcb-devel \
libxkbcommon-devel \
openssl-devel \
pkg-config
WSL2 wsl2
In addition to the above packages for Linux, you also need to run:
sudo apt-get -y install \
libvulkan1 \
libxcb-randr0 \
mesa-vulkan-drivers \
adwaita-icon-theme-full
TODO(#1250): Running with the wayland window manager
sometimes causes Rerun to crash. Try unsetting the wayland display (unset WAYLAND_DISPLAY
or WAYLAND_DISPLAY=
) as a workaround.
If you have a multi-gpu setup, Mesa may only report the integrated GPU such that Rerun can't pick the dedicated graphics card.
To mitigate that set export MESA_D3D12_DEFAULT_ADAPTER_NAME=NVIDIA
(or export MESA_D3D12_DEFAULT_ADAPTER_NAME=AMD
respectively for an AMD graphics card).
Since the Mesa driver on WSL dispatches to the Windows host graphics driver, it is important to keep the Windows drivers up-to-date as well. For example, line rendering issues have been observed when running from WSL with an outdated AMD driver on the Windows host.
pip install
issues pip-install-issues
If you see the following when running pip install rerun-sdk
or pip install rerun-notebook
on a supported platform:
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 startup-issues
If Rerun is having trouble starting, you can try resetting its memory with:
rerun reset
Graphics issues graphics-issues
Make sure to keep your graphics drivers updated.
Wgpu (the graphics API we use) maintains a list of known driver issues and workarounds for them.
The configuration we use for wgpu can be influenced in the following ways:
- pass
--renderer=<backend>
on startup:<backend>
must be one ofvulkan
,metal
orgl
for native and eitherwebgl
orwebgpu
for the web viewer (see also--web-viewer
argument). Naturally, support depends on your OS. The default backend isvulkan
everywhere except on Mac where we usemetal
. On the web we prefer WebGPU and fall back automatically to WebGL if no support for WebGPU was detected.- For instance, you can try
rerun --renderer=gl
or for the web viewer respectivelyrerun --web-viewer --renderer=webgl
. - Alternatively, for the native viewer you can also use the
WGPU_BACKEND
environment variable with the above values. - The web viewer is configured by the
renderer=<backend>
url argument, e.g. [https://rerun.io/viewer?renderer=webgl]
- For instance, you can try
WGPU_POWER_PREF
: Overwrites the power setting used for choosing a graphics adapter, must behigh
orlow
. (Default ishigh
)
We recommend setting these only if you're asked to try them or know what you're doing, since we don't support all of these settings equally well.
Multiple GPUs multiple-gpus
When using Wgpu's Vulkan backend (the default on Windows & Linux) on a computer that has both integrated and dedicated GPUs, a lot of issues can arise from Vulkan either picking the "wrong" GPU at runtime, or even simply from the fact that this choice conflicts with other driver picking technologies (e.g. NVIDIA Optimus).
In both cases, forcing Vulkan to pick either the integrated or discrete GPU (try both!) using the VK_ICD_FILENAMES
environment variable might help with crashes, artifacts and bad performance. E.g.:
- Force the Intel integrated GPU:
- Linux:
export VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/intel.json
.
- Linux:
- Force the discrete Nvidia GPU:
- Linux:
export VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/nvidia.json
. - Windows:
set VK_ICD_FILENAMES=\windows\system32\nv-vk64.json
.
- Linux: