gershwin-on-freebsd
Public
Pull mirror status: ok
P
Update script to use lowercase bootstrap and checkout
.github
Switch publish step from upload.sh to gh release
resources
Revert "Replace piecemeal init_script with init_chroot + unionfs pivot"
build.sh
Update script to use lowercase bootstrap and checkout
LICENSE
Revise copyright information in LICENSE file
README.md
Updating to use changes for Developer

Gershwin-on-FreeBSD

Build system for generating Gershwin Desktop live media based on FreeBSD.

Architecture

  • build.sh: The main build orchestrator.
  • resources/:
    • config/: System configuration templates and package repository configs.
    • packages/: Clean package lists for base system, drivers, and Gershwin.
    • scripts/: Low-level ISO generation scripts.
    • overlays/: Files injected into the live system and boot environment.

Requirements

  • A FreeBSD or FreeBSD host system.
  • Superuser privileges (root).
  • At least 20GB of free disk space and 4GB of RAM.

Getting Started

  1. Install Build Dependencies:

    pkg install git transmission-utils makefs

  2. Run the Build:

    sudo ./build.sh

The resulting ISO and its SHA256 checksum will be located in /usr/local/freebsd-build/iso/.

Live Environment

The live system uses a memory-efficient uzip and nullfs layering architecture. The default user is admin with no password required.