{"id":29893094,"url":"https://github.com/bluebootsy/os","last_synced_at":"2025-08-01T03:02:28.296Z","repository":{"id":306130724,"uuid":"1022219159","full_name":"bluebootsy/os","owner":"bluebootsy","description":"A Fedora BootC OS themed like it's 2003, but updated like it's 2025.","archived":false,"fork":false,"pushed_at":"2025-07-23T19:04:21.000Z","size":4056,"stargazers_count":3,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-23T21:29:10.339Z","etag":null,"topics":["bootc","fedora","linux","os"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bluebootsy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-07-18T16:53:15.000Z","updated_at":"2025-07-23T21:08:33.000Z","dependencies_parsed_at":"2025-07-23T21:39:32.442Z","dependency_job_id":null,"html_url":"https://github.com/bluebootsy/os","commit_stats":null,"previous_names":["bluebootsy/os"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/bluebootsy/os","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluebootsy%2Fos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluebootsy%2Fos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluebootsy%2Fos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluebootsy%2Fos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bluebootsy","download_url":"https://codeload.github.com/bluebootsy/os/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluebootsy%2Fos/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268162257,"owners_count":24205698,"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","status":"online","status_checked_at":"2025-08-01T02:00:08.611Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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","linux","os"],"created_at":"2025-08-01T03:00:50.177Z","updated_at":"2025-08-01T03:02:28.272Z","avatar_url":"https://github.com/bluebootsy.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Blueboots: Retro Looks, Atomic Upgrades\n\n\u003e A Fedora BootC OS themed like it's 2003, but updated like it's 2025.\n\n[![Container Repository on Quay](https://quay.io/repository/blueboots/os/status \"Container Repository on Quay\")](https://quay.io/repository/blueboots/os)\n\n![banner](https://raw.githubusercontent.com/bluebootsy/docs/refs/heads/main/img/banner.png)\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"https://raw.githubusercontent.com/bluebootsy/docs/refs/heads/main/img/screenshot.png\" alt=\"Screenshot\" /\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://raw.githubusercontent.com/bluebootsy/docs/refs/heads/main/img/laptop.png\" alt=\"Laptop running Blueboots\" /\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\nA graphical, declarative OS with a retro theme ([Bluecurve](https://github.com/neeeeow/Bluecurve)) reminiscent of [Fedora Core 1.0](https://en.wikipedia.org/wiki/Fedora_Linux#History).  \nUsing [bootc](https://bootc-dev.github.io/bootc/) for transactional upgrades!\n\nAll built within only **ONE FILE** (`Containerfile`)!\n\nThis main OS image is hosted on Quay.io:\n\n```sh\npodman pull quay.io/blueboots/os\n```\n\n[1] Technically the `/theme` folder is passed in. Otherwise, everything is in a single `Containerfile`!\n\n## Topics\n\n- [Technology](#technology)\n- [Important Notes](#important-notes)\n- [Requirements](#requirements)\n- [Usage](#usage)\n- [Advanced Usage](#advanced-usage)\n- [Known Issues](#known-issues)\n\n## Technology\n\nThis **Bootable Container (bootc)** OS uses [bootc-image-builder](https://github.com/osbuild/bootc-image-builder) to produce bootable *container* disk images.\n\nYou will use this to **add users** so you can log in!\n\nOnce a machine is created from the disk image, it can apply transactional updates *in place* from newly pushed container images (no need to rebuild the disk image). After you push a new image (`podman push`), just run `bootc upgrade` on the system and reboot.\n\n### Default software\n\nThere are some default applications bundled into this OS in additional to the default Fedora images:\n\n* Visual Studio Code (core)\n* Laptop and server hardware support (core)\n* WiFi hardware support (core)\n* Container tools such as Podman (core)\n* Wireguard support (core)\n* Firefox (Flatpak)\n* Podman Desktop (Flatpak)\n\n### Learning more about bootc\n\nIf you want to learn more about bootable containers, see the [Fedora Getting Started Guide](https://docs.fedoraproject.org/en-US/bootc/getting-started/) for videos, demos, best practices and more details.\n\n## IMPORTANT NOTES\n\n- To install additional software, use [Flatpak](https://flatpak.org/).\n- Want to install a package to the **core** of the OS? See [Advanced Usage](#advanced-usage).\n- ONLY generic GPU drivers are included (Intel iGPU, AMD iGPU, etc.) from `@hardware-support` in RHEL-derivative OSes.\n- No NVIDIA GPU support yet (upcoming).\n- No AMD GPU support yet (upcoming).\n\n## Requirements\n\n### Prerequisites: Software and hardware requirements\n\nWe have to initially build our OS! So look below for requirements.\n\n**OS:**  \nCompatible on Windows, macOS \u0026 Linux.\n\n**Software:**\n\n- [Podman Desktop](https://github.com/containers/podman-desktop)\n- [BootC Extension for Podman Desktop](https://github.com/podman-desktop/extension-bootc)\n\n## Usage\n\n1. **Pull the container image:**\n\n   \u003e Pull via CLI or within Podman Desktop\n\n   ```sh\n   podman pull quay.io/blueboots/os\n   ```\n\n   ![pulling container](https://raw.githubusercontent.com/bluebootsy/docs/refs/heads/main/img/pulling.png)\n\n2. **(Alternatively) Build your own bootc-enabled Containerfile:**\n\n   \u003e Git clone this project and build your image locally.\n\n   ```sh\n   git clone http://github.com/bluebootsy/os\n   podman build -t quay.io/foo/bar .\n   ```\n\n3. **Build the disk image:**\n\n   \u003e Use the Podman Desktop BootC extension. Make sure you provide your username and password.\n\n   **Important note:** Use the *interactive installer* within the BootC extension to add your username and password! Otherwise you will **NOT BE ABLE TO LOGIN**.\n\n   1. Choose either `.iso` for an *unattended ISO installer* which will **AUTOMATICALLY WIPE THE FIRST AVAILABLE DISK** (use with caution!), or `.raw`/other image types for local testing (e.g. writing to a USB stick).\n   2. Add your username and password for logging in, as well as your group (e.g. `wheel` for passwordless sudo).\n\n   **LET ME REPEAT.**  \n   **IF YOU CREATE THE .ISO, IT WILL AUTO-INSTALL TO YOUR FIRST AVAILABLE DISK AFTER SELECTING IT FOR BOOTING.**\n\n   ![building image](https://raw.githubusercontent.com/bluebootsy/docs/refs/heads/main/img/building.png)\n\n4. **Installation:**\n\n   **If you chose ISO:**  \n   1. \"Write\" the ISO using [balenaEtcher](https://etcher.balena.io/) or [Fedora Media Writer](https://en.wikipedia.org/wiki/Fedora_Media_Writer) to a USB stick.  \n   2. Plug into a PC and select the USB from the boot screen.  \n   3. Watch as it installs unattended to the first available drive.\n\n   **If you chose RAW:**  \n   1. You can \"write\" the `.raw` image with the above tools (balenaEtcher or Fedora Media Writer) to a USB stick.  \n   2. Plug into a PC and select the USB from the boot screen.  \n   3. Test out the \"live\" image.\n\n## Advanced Usage\n\n### Making changes to your OS\n\nWant to change a \"core\" package or make system changes that propagate to your OS? Follow below!\n\n#### Adding \"flatpak\" software\n\nSoftware that is _consistently_ being upgraded should be installed as a [Flatpak](https://flatpak.org/).\n\nWe recommend using [Flathub](https://flathub.org/) as the main way of installing new software.\n\nThis can be done on the command line after your OS has booted:\n\n```sh\nflatpak install flathub org.mozilla.firefox\n```\n\n#### Adding \"core\" software \u0026 system changes\n\nIn this example we will **add a basic package** called [`figlet`](http://www.figlet.org/):\n\n1. **Edit your `Containerfile`:**\n\n   Within the [Containerfile](/Containerfile) add the following to the list of packages:\n\n   ```Dockerfile\n   RUN dnf install -y \\\n     # ... other packages ... \\\n     figlet \u0026\u0026 \\\n     dnf clean all \u0026\u0026 \\\n     rm -rf /var/cache/dnf\n   ```\n\n2. **Build \u0026 push your container:**\n\n   ```sh\n   podman build -t quay.io/foo/bar .\n   podman push quay.io/foo/bar\n   ```\n\n3. **Run `bootc upgrade` on your OS:**\n\n   The command downloads your hosted image and applies updates on next reboot.\n\n   ```sh\n   bootc upgrade\n   ```\n\n4. **Reboot and check that `figlet` is installed!**\n\n   ```sh\n   $ figlet \"Hi\"\n    _   _ _ \n   | | | (_) \n   | |_| | | \n   |  _  | | \n   |_| |_|_|\n   ```\n\n### Using the `bootc` CLI tool\n\nThe `bootc` CLI is the bread-and-butter of bootc-derived images. Once booted, you can manage the system with:\n\n- **Status:** `bootc status` shows the current image and version.\n- **Upgrade:** `bootc upgrade` pulls the latest OCI image to apply next reboot.\n- **Fetch:** `bootc fetch` pre-downloads an update without applying it.\n- **Install:** `bootc install --target /dev/sdX` writes the OS to a block device (useful when live-booting from USB for testing).\n\nSee the official docs: \u003chttps://bootc-dev.github.io/bootc\u003e\n\n## Known Issues\n\nNo GPU support for NVIDIA and AMD (yet).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluebootsy%2Fos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbluebootsy%2Fos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluebootsy%2Fos/lists"}