{"id":26221403,"url":"https://github.com/nihaiden/watschenbam","last_synced_at":"2026-05-17T23:34:31.862Z","repository":{"id":281997319,"uuid":"946102313","full_name":"NiHaiden/watschenbam","owner":"NiHaiden","description":"Oida, rüttel ned am Watschenbam!","archived":false,"fork":false,"pushed_at":"2025-03-10T16:01:03.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-12T08:42:45.476Z","etag":null,"topics":["bootc","fedora","universal-blue"],"latest_commit_sha":null,"homepage":"","language":"Just","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NiHaiden.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-10T16:01:00.000Z","updated_at":"2025-03-10T16:07:14.000Z","dependencies_parsed_at":"2025-03-12T08:52:46.538Z","dependency_job_id":null,"html_url":"https://github.com/NiHaiden/watschenbam","commit_stats":null,"previous_names":["nihaiden/watschenbam"],"tags_count":0,"template":false,"template_full_name":"ublue-os/image-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiHaiden%2Fwatschenbam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiHaiden%2Fwatschenbam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiHaiden%2Fwatschenbam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NiHaiden%2Fwatschenbam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NiHaiden","download_url":"https://codeload.github.com/NiHaiden/watschenbam/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243249210,"owners_count":20260799,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootc","fedora","universal-blue"],"created_at":"2025-03-12T16:20:07.312Z","updated_at":"2025-12-28T03:04:33.642Z","avatar_url":"https://github.com/NiHaiden.png","language":"Just","funding_links":[],"categories":[],"sub_categories":[],"readme":"# image-template\n\n# Purpose\n\nThis repository is meant to be a template for building your own custom Universal Blue image. This template is the recommended way to make customizations to any image published by the Universal Blue Project:\n- [Aurora](https://getaurora.dev/)\n- [Bazzite](https://bazzite.gg/)\n- [Bluefin](https://projectbluefin.io/)\n- [uCore](https://projectucore.io/)\n- [main](https://github.com/ublue-os/main/)\n- [hwe](https://github.com/ublue-os/hwe/)\n\nor any other base image if you want to start from scratch:\n\n- Fedora: `quay.io/fedora/fedora-bootc:41`\n- CentOS Stream 9: `quay.io/centos-bootc/centos-bootc:stream9`\n- CentOS Stream 10 (in development): `quay.io/centos-bootc/centos-bootc:stream10`\n\nThis template includes a Containerfile and a Github workflow for building the container image, signing, and proper metadata to be listed on [artifacthub](https://artifacthub.io/). As soon as the workflow is enabled in your repository, it will build the container image and push it to the Github Container Registry.\n\n# Prerequisites\n\nWorking knowledge in the following topics:\n\n- Containers\n  - https://www.youtube.com/watch?v=SnSH8Ht3MIc\n  - https://www.mankier.com/5/Containerfile\n- bootc\n  - https://containers.github.io/bootc/\n- Fedora Silverblue (and other Fedora Atomic variants)\n  - https://docs.fedoraproject.org/en-US/fedora-silverblue/\n- Github Workflows\n  - https://docs.github.com/en/actions/using-workflows\n\n# How to Use\n\n## Template\n\nSelect `Use this Template` and create a new repository from it. To enable the workflows, you may need to go the `Actions` tab of the new repository and click to enable workflows.\n\n## Containerfile\n\nThis file defines the operations used to customize the selected image. It contains examples of possible modifications, including how to:\n- change the upstream from which the custom image is derived\n- add additional RPM packages\n- add binaries as a layer from other images\n\n## Building an ISO\n\nModify `iso.toml` to point to your custom image before generating an ISO.\n\n- (Steps in progress)\n\n## Workflows\n\n### build.yml\n\nThis workflow creates your custom OCI image and publishes it to the Github Container Registry (GHCR). By default, the image name will match the Github repository name.\n\n#### Container Signing\n\nContainer signing is important for end-user security and is enabled on all Universal Blue images. It is recommended you set this up, and by default the image builds *will fail* if you don't.\n\nThis provides users a method of verifying the image.\n\n1. Install the [cosign CLI tool](https://edu.chainguard.dev/open-source/sigstore/cosign/how-to-install-cosign/#installing-cosign-with-the-cosign-binary)\n\n2. Run inside your repo folder:\n\n    ```bash\n    cosign generate-key-pair\n    ```\n\n    \n    - Do NOT put in a password when it asks you to, just press enter. The signing key will be used in GitHub Actions and will not work if it is encrypted.\n\n\u003e [!WARNING]\n\u003e Be careful to *never* accidentally commit `cosign.key` into your git repo.\n\n3. Add the private key to GitHub\n\n    - This can also be done manually. Go to your repository settings, under Secrets and Variables -\u003e Actions\n    ![image](https://user-images.githubusercontent.com/1264109/216735595-0ecf1b66-b9ee-439e-87d7-c8cc43c2110a.png)\n    Add a new secret and name it `SIGNING_SECRET`, then paste the contents of `cosign.key` into the secret and save it. Make sure it's the .key file and not the .pub file. Once done, it should look like this:\n    ![image](https://user-images.githubusercontent.com/1264109/216735690-2d19271f-cee2-45ac-a039-23e6a4c16b34.png)\n\n    - (CLI instructions) If you have the `github-cli` installed, run:\n\n    ```bash\n    gh secret set SIGNING_SECRET \u003c cosign.key\n    ```\n\n4. Commit the `cosign.pub` file to the root of your git repository.\n\n# Community\n\n- [**bootc discussion forums**](https://github.com/containers/bootc/discussions) - Nothing in this template is ublue specific, the upstream bootc project has a discussions forum where custom image builders can hang out and ask questions.\n- Index your image on [artifacthub.io](https://artifacthub.io), use the `artifacthub-repo.yml` file at the root to verify yourself as the publisher. [Discussion thread](https://universal-blue.discourse.group/t/listing-your-custom-image-on-artifacthub/6446)\n\n## Community Examples\n\n- [m2os](https://github.com/m2giles/m2os)\n- [bos](https://github.com/bsherman/bos)\n- [homer](https://github.com/bketelsen/homer/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnihaiden%2Fwatschenbam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnihaiden%2Fwatschenbam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnihaiden%2Fwatschenbam/lists"}