You can set
RUST_LOG=debug before running to get some verbose logging output.
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.
If Rerun is having trouble starting, you can try resetting its memory with:
The following environment variables overwrite the config we choose for wgpu:
WGPU_BACKEND: Overwrites the graphics backend used, must be one of
gl. Naturally, support depends on your OS. Default is
vulkaneverywhere except on Mac where we use
WGPU_POWER_PREF: Overwrites the power setting used for choosing a graphics adapter, must be
low. (Default is
For instance, you can try
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.
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:
- Force the discrete Nvidia GPU: