Fork Your Own image

Contributing
1

Making your own image by forking Bazzite, Bluefin, or Aurora

Sometimes you don’t want to make a whole new image from scratch, you just want to change some things without too much extra work. Sometimes it’s nicer to derive from images that more end-user focused like Bazzite, Bluefin, and Aurora.

Using the Image template

Use the official template image to build off of to make your own custom Bazzite, Bluefin, or Aurora if preferred over forking the project.

Use Cases

  • You want to help development by being able to test your contributions prior to submiting to the community.
    • Hardware enablement, experimental features, confirming fixes ahead of merge
  • You want to change out applications and other default choices but want to stick close to Bazzite/Bluefin to get improvements automatically
    • For example, Bluefin DX has Visual Studio baked into the image. If you want the rest of it but don’t use vscode you could replace it or remove it.
    • You need to layer something like VPN software that has to be on an image but you don’t want to maintain your own standalone image. (Deriving off of others is always easier, that’s why we made this project)
    • You want a personal-use image with config and software changes, but also want to benefit from work being completed upstream.

ublue-os/main are used to generate base images of everything, so are usually not good candidates for this unless you are familiar with git, containers, and GitHub Actions.

7 Likes
2

@j0rge I am a bit confused if this post is the authoritative guide on how to create a custom image? Even in this post there is reference to the documentation/tinker category, but I think with the new website there is no current way to access this tinker category?

This post / video shows a very friendly way to get started with a custom image, but maybe that way isn’t kept up-to-date or supported now?

3

We’re working on new instructions, sorry this part’s kind of in limbo right now.

2 Likes
4

Much appreciated!, curiously waiting for the new instructions, please take your time :smile:

5

I have found https://blue-build.org/ which seems to piece together some of the confusion over where the prior documentation went to and why it was split off to this separate project. So the video I linked was using this method which isn’t aligned with uBlue’s current supported direction which is undergoing a re-write, as j0rge notes above.

1 Like
6

Thanks for the info, I did however stumble upon bluebuild before but didn’t try it out. Did you try it by any chance?

7

Hey guys, actually I made my own image using blue build yesterday, it was quite simple and I was also successful in making the changes I needed, rebasing to it was straightforward. I don’t think a user needs to have separate instructions.

This is my version of the image aka Pawzite :sweat_smile:

8

Although I was successful in making my own image with packages installed, I think the instructions are still needed for some system level stuff - like custom kernel installation, custom de configuration ootb and other things

1 Like
9

Between the following I take it blue-build is the way forward?