create-ublue-image
This is a small containerized tool to automatically create a functional Github repository custom ostree native container image based on ublue-os/startingpoint.
I'm working on a web-based version at ublue-os/images-website, but this one will also be maintained for the time being.
Running
create-ublue-image should run on any computer with Podman installed. If you are already running an immutable Fedora variant, you shouldn't have to install anything.
Run the following command in a directory that you have write access to, your repo will be created as a subdirectory. The script will ask you further questions.
podman run -v "$(pwd)":/host --security-opt label=disable -it ghcr.io/xynydev/create-ublue-image
It is not recommended to run the tool inside your home directory, but rather a subdirectory, as that can cause errors.
However, if the command tool starts in your home dir without any errors, it should probably function. You do not need to run the tool in an empty directory, it will create a new one with the name that you input.
This command runs the OCI container built in this repo using podman
mounting your working directory pwd
into the container under the path /host
. :z
makes it possible for multiple containers to use the volume at the same time, which is useful when running a Distrobox. If you run into issues with "relabeling" when running the command, you should try removing :z
from the end of the mount command.
Pull latest commits
In order to update changes from the upstream repository, run:
git fetch upstream
git merge upstream/main -m "chore: merging upstream changes"
Some instructions also exist in the uBlue docs: https://ublue.it/making-your-own/#automatic-setup
Can I trust you?
This tool uses github-cli
to authenticate to your account, which could be a security concern.
You can read all of the code in wizard.sh
(<100 loc) and see for yourself everything this tool does.
You can also just set up the repository manually.