Skip to content

Troubleshooting

Jump to bottom
BenJule edited this page May 31, 2026 · 1 revision

Troubleshooting

Common issues encountered during installation, building, and running BambuStudio.

Runtime Issues

gtk_window_resize: assertion 'width > 0' failed (Wayland)

Symptom: Warning printed to terminal on startup when running on Wayland:

(bambu-studio:12345): Gtk-WARNING **: gtk_window_resize: assertion 'width > 0' failed

Status: Fixed in master (PR #309). The fix defers SetSizeHints() to on_window_geometry() so it runs only after the Wayland compositor has realized the window.

Workaround (older versions): Set GDK_BACKEND=x11 to force X11 mode:

GDK_BACKEND=x11 bambu-studio

Application fails to start on Wayland — blank window

Symptom: BambuStudio window opens but is blank or immediately closes.

Try:

# Force X11 via XWayland
GDK_BACKEND=x11 bambu-studio

# Or set permanently in ~/.profile:
export GDK_BACKEND=x11

OpenGL errors on startup

Symptom:

libGL error: No matching fbConfigs or visuals found
libGL error: failed to load driver: swrast

Fix: Install Mesa drivers:

# Ubuntu/Debian
sudo apt install libgl1-mesa-dri mesa-vulkan-drivers

# Fedora
sudo dnf install mesa-dri-drivers mesa-vulkan-drivers

For virtual machines or headless environments, use software rendering:

LIBGL_ALWAYS_SOFTWARE=1 bambu-studio

Crash on startup — missing shared library

Symptom:

bambu-studio: error while loading shared libraries: libXXX.so.X: cannot open shared object file

Fix (AppImage): AppImages are self-contained and should not have this issue. If it occurs, the AppImage may be corrupted — re-download it.

Fix (.deb / .rpm): Install missing dependencies:

# Debian/Ubuntu — resolve broken deps
sudo apt-get install -f

# Fedora
sudo dnf install --fix-broken

Version shown as 0.0.0.0 in splash screen

Symptom: Splash screen or About dialog shows 0.0.0.0 instead of the actual version.

Cause: The binary was built without the version being embedded (usually a build from source without proper git tag).

Fix: Build with a git tag present:

git tag v02.07.00.55-dev   # or any version tag
./BuildLinux.sh -sfr

Installation Issues

APT: NO_PUBKEY error

Symptom:

W: GPG error: https://apt.s3-dev.ovh stable InRelease: The following signatures couldn't be verified because the public key is not available: NO_PUBKEY ...

Fix: Re-import the signing key:

sudo rm /etc/apt/trusted.gpg.d/bambustudio.gpg
curl -fsSL https://apt.s3-dev.ovh/KEY.gpg \
  | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/bambustudio.gpg
sudo apt update

APT: Repository not found / 404

Symptom: 404 Not Found when running apt update

Check: The repo URL is https://apt.s3-dev.ovh stable main. Verify /etc/apt/sources.list.d/bambustudio.list:

cat /etc/apt/sources.list.d/bambustudio.list
# Should output:
# deb [signed-by=/etc/apt/trusted.gpg.d/bambustudio.gpg] https://apt.s3-dev.ovh stable main

dpkg-deb extraction fails

When extracting a .deb without root:

dpkg-deb -x bambustudio_*.deb ./extracted/

This works without sudo but dpkg -i requires root. Use apt install ./bambustudio_*.deb to handle dependencies automatically.

Build Issues

Deps build fails — CMake version too old

Symptom:

CMake 3.25 or higher is required.

Fix: Install a newer CMake:

# Ubuntu — use Kitware APT repo
wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc | sudo apt-key add -
sudo apt-add-repository "deb https://apt.kitware.com/ubuntu/ $(lsb_release -cs) main"
sudo apt update && sudo apt install cmake

Or let BuildLinux.sh -u handle it — it installs the required version automatically.

Build fails — out of memory (OOM)

Symptom: Build killed mid-way, system becomes unresponsive.

Fix: Reduce parallelism:

# In BuildLinux.sh, the -j flag controls jobs. Override:
export CMAKE_BUILD_PARALLEL_LEVEL=2
./BuildLinux.sh -sfr

Or add swap space:

sudo fallocate -l 8G /swapfile
sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile

git-lfs missing — binary files corrupt

Symptom: Binary assets (textures, test files) are 134-byte pointer files instead of the actual content.

Fix:

sudo apt install git-lfs        # or your distro's equivalent
git lfs install
git lfs pull

ccache not working in local build

Symptom: Build times are not improving after the first build.

Check ccache stats:

ccache --show-stats

Fix: Ensure ccache is on PATH before the compiler:

export PATH="/usr/lib/ccache:$PATH"
# Verify:
which gcc   # Should show /usr/lib/ccache/gcc

CI Issues

PR build fails — disk space

Symptom: GitHub-hosted runner runs out of disk space mid-build.

Disk space on ubuntu-24.04 runners is limited (~14 GB usable). The deps cache significantly reduces disk usage. If the cache is cold and the runner fills up, re-trigger the run — the cache will be populated on success.

Self-hosted runner offline

Symptom: Job is queued but never starts. In Actions log: Waiting for a runner to pick up this job...

Check: Go to Settings → Actions → Runners and verify runner status.

Fix on the VM:

sudo systemctl restart actions.runner.BenJule-BambuStudio.<runner-name>.service
sudo systemctl status actions.runner.*

Zombie PR build still running after merge

Expected behavior: GitHub does not auto-cancel PR builds on merge. Cancel manually:

# Find the run ID
gh run list --workflow=ci-pull-request.yml --limit 5

# Cancel
gh run cancel <run-id>

Nightly build stuck for 4+ hours

The nightly has a timeout-minutes: 360 (6 hours) per job. If it appears stuck:

# Check which job is stuck
gh run view <run-id>

# Cancel and restart
gh run cancel <run-id>
gh workflow run cd-nightly.yml --ref master

Getting Help

If your issue is not listed here:

  1. Search existing issues: github.com/BenJule/BambuStudio/issues
  2. Open a new issue using the bug report template
  3. For build questions, check Building-from-source-Linux, Building-from-source-macOS, or Building-from-source-Windows
  4. For upstream BambuStudio issues, check the upstream issue tracker

Clone this wiki locally