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
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
On 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 setting WINIT_UNIX_BACKEND=x11
as a workaround.
Startup issues
If Rerun is having trouble starting, you can try resetting its memory with:
rerun reset
Graphics issues
Wgpu (the graphics API we use) maintains a list of known driver issues and workarounds for them.
The following environment variables overwrite the config we choose for wgpu:
WGPU_BACKEND
: Overwrites the graphics backend used, must be one ofvulkan
,metal
,dx12
,dx11
, orgl
. Naturally, support depends on your OS. Default isvulkan
everywhere except on Mac where we usemetal
.WGPU_POWER_PREF
: Overwrites the power setting used for choosing a graphics adapter, must behigh
orlow
. (Default ishigh
)
For instance, you can try WGPU_BACKEND=gl rerun
.
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
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: