Skip to content

Initiate landing site build #3

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

Merged
merged 10 commits into from
Jul 25, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
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
43 changes: 43 additions & 0 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
name: Build site

on:
push:
branches: [ "main" ]
pull_request:
types:
- opened
- reopened
- synchronize
- closed

concurrency: preview-${{ github.ref }}

env:
CARGO_TERM_COLOR: always

jobs:
build_and_deploy:
runs-on: ubuntu-latest
if: github.ref == 'refs/heads/main'
steps:
- name: Check out repository
uses: actions/checkout@v4
- name: Build and deploy
uses: shalzz/[email protected]
env:
PAGES_BRANCH: gh-pages
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
preview:
runs-on: ubuntu-latest
if: github.ref != 'refs/heads/main'
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Install and build
if: github.event.action != 'closed'
uses: shalzz/[email protected]
env:
BUILD_ONLY: true
BUILD_FLAGS: --drafts
BUILD_THEMES: false
CHECK_LINKS: true
4 changes: 4 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
site/public/
.idea

.DS_Store
25 changes: 25 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1 +1,26 @@
# This is the main site!

This site is built using [Zola](https://www.getzola.org/), a static site generator built with Rust. The theme is [Juice](https://www.getzola.org/themes/juice/).
- Zola [Installation instructions](https://www.getzola.org/documentation/getting-started/installation/)
- Juice [Installation info](https://juice.huhu.io/#installation) - Note that I've explicitly dropped the git history and VCS info from the theme directory.

Under the hood, Zola uses [Tera](https://keats.github.io/tera/) for templating.

## Structure

The site lives in the `site` directory. Content like pages or blog posts live in, appropriately, `content`. Any kind of image like screenshots would live in `static`.

The `templates` directory extends elements from the theme, which is stored in, appropriately, `themes/juice`.

## Building

Once you've installed Zola, proceed as follows:

```bash
cd site
zola serve
```

Go to the URL for the webserver (likely `localhost:1111`) to explore the site.

You can also use `zola build` to build it once to the `public` directory if you so choose.
62 changes: 62 additions & 0 deletions config.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
base_url = "https://bootc.dev"
#base_url = "http://localhost"
theme = "juice"
title = "bootc"
description = "A tool to build operating systems like we build containers"

default_language = "en"
#languages =
#translations =

# Whether to automatically compile all Sass files in the sass directory
compile_sass = true

# Whether to build a search index to be used later on by a JavaScript library
build_search_index = true

generate_feeds = true
#feed_limit =
feed_filenames = ["rss.xml"]

#hard_link_static =
#taxonomies =
#author =
#compile_sass
#minify_html
#ignored_content
#ignored_static
#mode
#output_dir
#preserve_dotfiles_in_output
#link_checker
#slugify
#search
generate_sitemap = true
generate_robots_txt = true
#exclude_paginated_pages_in_sitemap

[markdown]
# Whether to do syntax highlighting
# Theme can be customised by setting the `highlight_theme` variable to a theme supported by Zola
highlight_code = true
highlight_theme = "inspired-github"
render_emoji = true
external_links_class = "external"
external_links_target_blank = true
external_links_no_referrer = true
#insert_anchor_links = "left"

[extra]
# Put all your custom variables here
juice_logo_name = "bootc"
juice_logo_path = "logo.png"
juice_extra_menu = [
{ title = "About", link = "/about", external = false },
{ title = "Docs", link = "https://bootc-dev.github.io/bootc/", external = true },
{ title = "News", link = "/news", external = false },
{ title = "GitHub", link = "https://github.com/bootc-dev/bootc", external = true },
]
favicon = "favicon.ico"
meta_title = "Your OS, but Containers!"
meta_description = "bootc builds operating systems using containerization principles"
footer = ""
55 changes: 55 additions & 0 deletions content/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
title: bootc
---

Transactional, in-place operating system updates using OCI/Docker container images.

## Motivation

The original Docker container model of using "layers" to model applications has been extremely successful. This project aims to apply the same technique for bootable host systems - using standard OCI/Docker containers as a transport and delivery format for base operating system updates.

The container image includes a Linux kernel (in e.g. `/usr/lib/modules`), which is used to boot. At runtime on a target system, the base userspace is *not* itself running in a "container" by default. For example, assuming systemd is in use, systemd acts as pid1 as usual---there's no "outer" process. More about this in the docs; see below.

## Status

The CLI and API are considered stable. We will ensure that every existing system can be upgraded in place seamlessly across any future changes.

## Documentation

The project documentation is hosted on a different site: [Docs](https://bootc-dev.github.io/bootc/)

## Versioning

Although bootc is not released to crates.io as a library, version numbers are expected to follow [semantic versioning](https://semver.org/) standards. This practice began with the release of version 1.2.0; versions prior may not adhere strictly to semver standards.

## Adopters (base and end-user images)

The bootc CLI is just a client system; it is not tied to any particular operating system or Linux distribution. You very likely want to actually start by looking at [ADOPTERS.md](about/adopters).

## Community discussion

- [Github discussion forum](https://github.com/containers/bootc/discussions) for async discussion
- [#bootc-dev on CNCF Slack](https://cloud-native.slack.com/archives/C08SKSQKG1L) for live chat
- Recurring live meeting hosted on [CNCF Zoom](https://zoom-lfx.platform.linuxfoundation.org/meeting/96540875093?password=7889708d-c520-4565-90d3-ce9e253a1f65) each Friday at 15:30 UTC.
- [Meeting notes on HackMD](https://hackmd.io/@cgwalters/HJk3Aj0ree/edit)

This project is also currently tightly related to the previously mentioned Fedora/CentOS bootc project, and many developers monitor the relevant discussion forums there. In particular, there's a Matrix channel and a weekly chat meeting; [learn more](https://docs.fedoraproject.org/en-US/bootc/community/).

## Developing bootc

Are you interested in working on bootc? Great! Reference our [contribution guide](about/contributing).
There is also a list of [Maintainers](about/maintainers).

## Governance
Reference [Governance](about/governance) for project governance details.

## Badges

[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/10113/badge)](https://www.bestpractices.dev/projects/10113)

### Code of Conduct

The bootc project is a [Cloud Native Computing Foundation (CNCF) Sandbox project](https://www.cncf.io/sandbox-projects/) and adheres to the [CNCF Community Code of Conduct](https://github.com/cncf/foundation/blob/main/code-of-conduct.md).

---
The Linux Foundation® (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see [Trademark Usage](https://www.linuxfoundation.org/trademark-usage/).
7 changes: 7 additions & 0 deletions content/about/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
+++
title = "Project information"
description = "About the project"
weight = 1
+++

Use these pages to learn more about the project, our governance, and adopters.
12 changes: 12 additions & 0 deletions content/about/about.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
+++
title = "About"
description = "About bootc"
weight = 1
toc = true
+++

# So what is bootc?

Imagine the ability to set up your operating system using a file you can check into source control. bootc basically turns your operating system into a containerized system, complete with in-place updates, custom configurations and pre-installed software and drivers, and more. You can share your custom containerized operating system image with others, too.

Unlock the power of bootc with shared custom OS images.
10 changes: 10 additions & 0 deletions content/about/adopters.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
+++
title = "Adopters"
description = "End User Adopters"
template = "imported.html"
weight = 9
toc = true
[extra]
fileimport = "ADOPTERS"
+++

5 changes: 5 additions & 0 deletions content/about/changelog.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
+++
title = "Changelog"
description = "Changelog"
weight = 2
+++
10 changes: 10 additions & 0 deletions content/about/contributing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
+++
title = "Contributing"
description = "Contributing"
template = "imported.html"
weight = 3
toc = true
[extra]
fileimport = "CONTRIBUTING"
+++

9 changes: 9 additions & 0 deletions content/about/governance.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
+++
title = "Governance"
description = "Project governance"
template = "imported.html"
weight = 4
toc = true
[extra]
fileimport = "GOVERNANCE"
+++
10 changes: 10 additions & 0 deletions content/about/maintainers.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
+++
title = "Maintainers"
description = "Project maintainers"
template = "imported.html"
weight = 5
toc = true
[extra]
fileimport = "MAINTAINERS"
+++

10 changes: 10 additions & 0 deletions content/about/security.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
+++
title = "Security"
description = "Security"
template = "imported.html"
weight = 6
toc = true
[extra]
fileimport = "SECURITY"
+++

41 changes: 41 additions & 0 deletions content/news/2025-07-11-community-meeting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
+++
title = "Bootc Community Meeting Notes - 11 July 2025"
date = 2025-07-11
slug = "2025-july-11-community-meeting"
+++

### Attendees:
- Joseph Marrero Corchado (Red Hat, Inc.)
- Colin Walters
- Robert Sturla (Tesco Bank/Universal Blue)
- Laura Santamaria (she/her)
- Hristo Marinov
- John Eckersberg (Red Hat, Inc.)
- Dusty (he/him)
- Antheas Kapenekakis (Bazzite)
- Mohan
- Chris Kyrouac
- Gursewak Mangat

### Agenda:
- New release status: [bootc-dev/bootc#1390](https://github.com/bootc-dev/bootc/issues/1390)
- folks agreed on this
- [Laura] [KubeCon NA 2025](https://events.linuxfoundation.org/kubecon-cloudnativecon-north-america/) [Project Pavilion application](https://events.linuxfoundation.org/kubecon-cloudnativecon-north-america/features-add-ons/project-opportunities/#description-of-opportunities)
- November 10-13 - Atlanta, Georgia
- Who is going to KubeCon NA 2025 already?
- Laura
- We'll get a project pavilion submission scheduled (probably from Joseph or Colin who already submitted a talk)
- Ublue - Collaboration
- Folks are joining :)
- Robert, Antheas from the Ublue community
- Colin would like to do 1:1s
- dustymabe: an office hours like set time could help facilitate this (+1 - Laura)
- [rechunker alignment](https://github.com/hhd-dev/rechunk)
- [progress-fd](https://github.com/bootc-dev/bootc/issues/1016)
- [systemd-sysext frontend](https://github.com/bootc-dev/bootc/issues/7)
- Motivated by combinatorial explosion of gnome|kde * nvidia|amd * surface|framework|lenovo
- discussion of downsides of systemd-sysext as defined today, vs

### TODO:
* [x] Put project pavilion application
* [x] Keep smaller, more focused meetings
49 changes: 49 additions & 0 deletions content/news/2025-07-18-community-meeting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
+++
title = "Bootc Community Meeting Notes - 18 July 2025"
date = 2025-07-18
slug = "2025-july-18-community-meeting"
+++

### Attendees:
- Laura Santamaria (she/her; Red Hat)
- Hristo Marinov
- Fernando Lozano
- Colin Walters (he/him; Red Hat)
- Joseph Marrero Corchado (Red Hat, Inc.)
- Matteo Piccinini (n/a)
- Robert Sturla (Tesco Bank)
- Dusty Mabe
- Chris Kyrouac
- Gursewak Mangat
- John Eckersberg (Red Hat, Inc.)

### Agenda:
- [Release 1.5.1](https://github.com/bootc-dev/bootc/pull/1422)
- Thanks @robert!
- [Laura] project pavilion update?
- Request form due Monday, shouldn't block on travel
- Let's do it live
- ✅
- [Laura] Static site generation for landing page
- Review!
- [bootc-dev/bootc-dev.github.io#3](https://github.com/bootc-dev/bootc-dev.github.io/pull/3)
- adding logos as examples: [CoreOS site](https://fedoraproject.org/coreos/); [BluefinOS](https://projectbluefin.io/)
- [Colin] QMU banned contributions from AI. Want to talk about it. Contribution policy?
- Thoughts?
- Require use of `<Assisted-by>` tag to identify model/tool
- Errant AI comment contributed to recent bug
- [John] +1 on attribution
- [Dusty] do we want to limit, or allow?
- [Colin] has a pretty big impact, so want to know what folks think
- [Joseph] note in readme or contributing section makes sense. Maybe have a bot that highlights that on PR? People probably won't say anything because part of workflow
- [Dusty] Can't prevent, but policy. Any examples of wasted time on clearly generated by AI PR
- [Colin] Can tell 90% of the time. Most modern foundational models love bulleted lists, so it's obvious. Kinda wacky to put md doc in top level of repo for PR
- [Laura] gave overview from OSPO and the other container group discussion
- [Colin] Will open a discussion

### TODO:
- [ ] Laura to explore adding logos to PR.
- [ ] Laura to add GitHub Actions for publication
- [ ] Look for info on domain handling for static site
- [ ] Colin to open a discussion about the AI assisted PRs
- [x] Laura to find and share the public Containers Cabal recording
7 changes: 7 additions & 0 deletions content/news/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
+++
title = "News"
weight = 8
sort_by = "date"
template = "news.html"
page_template = "news-page.html"
+++
5 changes: 0 additions & 5 deletions index.html

This file was deleted.

Binary file added static/favicon.ico
Binary file not shown.
1 change: 1 addition & 0 deletions static/img/cncf-color-bg.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading