https://github.com/white-gecko/bluejay
https://github.com/white-gecko/bluejay
atomic bluebuild bluebuild-image custom-image image-based immutable linux linux-custom-image oci oci-image operating-system
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/white-gecko/bluejay
- Owner: white-gecko
- License: apache-2.0
- Created: 2024-11-05T20:36:08.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-10T14:02:52.000Z (about 1 year ago)
- Last Synced: 2025-02-10T15:22:05.234Z (about 1 year ago)
- Topics: atomic, bluebuild, bluebuild-image, custom-image, image-based, immutable, linux, linux-custom-image, oci, oci-image, operating-system
- Language: Shell
- Size: 105 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# bluejay [](https://github.com/white-gecko/bluejay/actions/workflows/build.yml)
See the [BlueBuild docs](https://blue-build.org/how-to/setup/) for quick setup instructions for setting up your own repository based on this template.
After setup, it is recommended you update this README to describe your custom image.
## Features
- With [task](https://taskfile.dev/) and `utask`, just like `ujust`.
- With [fish](https://fishshell.com/) and [starship](https://starship.rs/)
- With running [pulsar](https://pulsar-edit.dev/)
- With [podman](https://podman.io/) and podman-docker (docker is removed)
- With [quarto](https://quarto.org/)
- Many more packages
## TODO
- Setup chezmoi
- organize fisher plugin management
## 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/white-gecko/bluejay: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/white-gecko/bluejay: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/white-gecko/bluejay
```
## Setup
There is the `utask` command, just like `ujust`, but with [task](https://taskfile.dev/).
### Configure the powerlevel10k prompt
```
utask setup:p10k
```
### Use LaTeX
To use latex install it in a toolbox, install zsh fasd fzf task texlive-import texlive-scheme-medium.