https://github.com/detiber/beardy-os

https://github.com/detiber/beardy-os

atomic bluebuild bluebuild-image custom-image image-based immutable linux linux-custom-image oci oci-image operating-system

Last synced: 26 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/detiber/beardy-os
• Owner: detiber
• License: apache-2.0
• Created: 2024-12-03T21:15:02.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-03T20:21:24.000Z (about 1 year ago)
• Last Synced: 2025-06-11T08:08:05.620Z (10 months ago)
• Topics: atomic, bluebuild, bluebuild-image, custom-image, image-based, immutable, linux, linux-custom-image, oci, oci-image, operating-system
• Language: Just
• Size: 111 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# beardy-os

[![build-beardy-base](https://github.com/detiber/beardy-os/actions/workflows/base-build.yml/badge.svg?branch=main)](https://github.com/detiber/beardy-os/actions/workflows/base-build.yml)

[![Latest Images](https://github.com/detiber/beardy-os/actions/workflows/bluefin-latest.yml/badge.svg)](https://github.com/detiber/beardy-os/actions/workflows/bluefin-latest.yml)

[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/beardy-os)](https://artifacthub.io/packages/search?repo=beardy-os)

## NOTE:

This repo is used for building os images layered upon various upstream bootc/ublue-os based images. Use at your own risk, and without any support.

## Installation

> **Warning**  

> [This is an experimental feature](https://www.fedoraproject.org/wiki/Changes/OstreeNativeContainerStable), try at your own discretion.

To rebase an existing atomic Fedora installation to the latest build:

- First rebase to the unsigned image, to get the proper signing keys and policies installed:

  ```

  rpm-ostree rebase ostree-unverified-registry:ghcr.io/detiber/beardy-os:latest

  ```

- Reboot to complete the rebase:

  ```

  systemctl reboot

  ```

- Then rebase to the signed image, like so:

  ```

  rpm-ostree rebase ostree-image-signed:docker://ghcr.io/detiber/beardy-os:latest

  ```

- Reboot again to complete the installation

  ```

  systemctl reboot

  ```

The `latest` tag will automatically point to the latest build. That build will still always use the Fedora version specified in `recipe.yml`, so you won't get accidentally updated to the next major version.

## ISO

If build on Fedora Atomic, you can generate an offline ISO with the instructions available [here](https://blue-build.org/learn/universal-blue/#fresh-install-from-an-iso). These ISOs cannot unfortunately be distributed on GitHub for free due to large sizes, so for public projects something else has to be used for hosting.

## Verification

These images are signed with [Sigstore](https://www.sigstore.dev/)'s [cosign](https://github.com/sigstore/cosign). You can verify the signature by downloading the `cosign.pub` file from this repo and running the following command:

```bash

cosign verify --key cosign.pub ghcr.io/detiber/beardy-os

```