Skip to content

Add bazzite to linux dependencies doc - #25707

Open
calebmeyer wants to merge 4 commits into
bevyengine:mainfrom
calebmeyer:add-bazzite
Open

Add bazzite to linux dependencies doc#25707
calebmeyer wants to merge 4 commits into
bevyengine:mainfrom
calebmeyer:add-bazzite

Conversation

@calebmeyer

Copy link
Copy Markdown

Objective

  • Add documentation on how to build and run bevy applications on bazzite

Solution

  • Adds instructions using distrobox

Testing

  • Did you test these changes? If so, how?
    Yes, I tested them on my local machine:
image
  • Are there any parts that need more testing?
    I did essentially hello world. If we want tests of sound, 3d rendering, people with nvidia GPUs, etc, I didn't (and can't for nvidia) test those.

  • How can other people (reviewers) test your changes? Is there anything specific they need to know?
    Get bazzite (even on a VM? Not sure how bevy does on VM) and try the commands.

  • If relevant, what platforms did you test these changes on, and are there any important ones you can't test?
    Bazzite for AMD:

image

@github-actions

github-actions Bot commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

Welcome, new contributor!

Please make sure you've read our contributing guide, as well as our policy regarding AI usage, and we look forward to reviewing your pull request shortly ✨

@calebmeyer

Copy link
Copy Markdown
Author

Apologies for the force push. I originally created the branch against latest instead of main, and had a lot of commits I wasn't expecting 😅

@calebmeyer calebmeyer changed the title Add bazzite Add bazzite to linux dependencies doc Sep 7, 2026
@alice-i-cecile alice-i-cecile added C-Docs An addition or correction to our documentation O-Linux Specific to the Linux desktop operating system X-Uncontroversial This work is generally agreed upon S-Needs-Review Needs reviewer attention (from anyone!) to move forward C-Machine-Specific This bug is isolated to specific hardware or driver configurations labels Sep 7, 2026

@alice-i-cecile alice-i-cecile left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks reasonable enough, but I can't test this myself.

@alice-i-cecile alice-i-cecile added D-Straightforward Simple bug fixes and API improvements, docs, test and examples A-Cross-Cutting Impacts the entire engine labels Sep 7, 2026

Bazzite is built atop an immutable version of Fedora. But it ships with distrobox, which we can use to get the development packages we need without installing them onto the immutable OS.

Create a new distrobox built on fedora:

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you find a better name than fedora?

Maybe bevy-builder or something similar?

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Applied Jengamon's suggestions below, please let me know if that covers your suggestion.

@Jengamon Jengamon left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mostly based on @mockersf's suggestion for renaming the box name, but these instructions work (I have a nearly identical setup, just using clang in place of gcc)

Comment thread docs/linux_dependencies.md Outdated
Comment thread docs/linux_dependencies.md Outdated
calebmeyer and others added 2 commits September 8, 2026 21:31
Co-authored-by: Uche Okwo <bob.hostern@gmail.com>
Co-authored-by: Uche Okwo <bob.hostern@gmail.com>
@calebmeyer

Copy link
Copy Markdown
Author

Thank you for the suggestions, everyone! I have applied your changes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-Cross-Cutting Impacts the entire engine C-Docs An addition or correction to our documentation C-Machine-Specific This bug is isolated to specific hardware or driver configurations D-Straightforward Simple bug fixes and API improvements, docs, test and examples O-Linux Specific to the Linux desktop operating system S-Needs-Review Needs reviewer attention (from anyone!) to move forward X-Uncontroversial This work is generally agreed upon

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants