Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: switch to bootc/dnf5 #40

Draft
wants to merge 7 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions Containerfile
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ FROM ghcr.io/ublue-os/base-main:latest


## Install a Desktop
# Use `dnf5 group list` to see possible group packages to install, or choose them individually

RUN dnf5 group install kde-desktop kde-apps

Expand Down
31 changes: 16 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,7 @@

# Purpose

This 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:
- [Aurora](https://getaurora.dev/)
- [Bazzite](https://bazzite.gg/)
- [Bluefin](https://projectbluefin.io/)
- [uCore](https://projectucore.io/)
- [main](https://github.com/ublue-os/main/)
- [hwe](https://github.com/ublue-os/hwe/)

This template includes a Containerfile and a Github workflow for building the container image. As soon as the workflow is enabled in your repository, it will build the container image and push it to the Github Container Registry.
This repository is meant to be a template for building your own custom Universal Blue image.

# Prerequisites

Expand All @@ -19,8 +11,8 @@ Working knowledge in the following topics:
- Containers
- https://www.youtube.com/watch?v=SnSH8Ht3MIc
- https://www.mankier.com/5/Containerfile
- rpm-ostree
- https://coreos.github.io/rpm-ostree/container/
- bootc
- https://containers.github.io/bootc/
- Fedora Silverblue (and other Fedora Atomic variants)
- https://docs.fedoraproject.org/en-US/fedora-silverblue/
- Github Workflows
Expand All @@ -34,10 +26,19 @@ Select `Use this Template` and create a new repository from it. To enable the wo

## Containerfile

This file defines the operations used to customize the selected image. It contains examples of possible modifications, including how to:
- change the upstream from which the custom image is derived
- add additional RPM packages
- add binaries as a layer from other images
The top line is the base image you want to start FROM. Any valid image can be a starting point, examples include:

`FROM ghcr.io/ublue-os/bazzite:latest`
`FROM ghcr.io/ublue-os/bluefin:stable`
`FROM ghcr.io/ublue-os/aurora-dx:stable`

## "Emtpy base images"

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo here


These contain a base system WITHOUT a prexisting desktop. This is recommended for
castrojo marked this conversation as resolved.
Show resolved Hide resolved

`FROM ghcr.io/ublue-os/base-main:latest`

Use `base-nvidia:latest` if you need the Nvidia drivers. You can also lock to a specific version like `base-nvidia:41`, etc.

## Workflows

Expand Down