Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
tool for creating supermin appliances
C OCaml Perl

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
examples
helper
lib
m4
.gitignore
COPYING
Makefile.am
README
TODO
autogen.sh
configure.ac
f10.log.gz
fakechroot-2.8-relchroot.patch
fakechroot-2.9-cmdsubst.patch
fakechroot-svn-no-dup-envs.patch
febootstrap-install.pod
febootstrap-install.sh
febootstrap-minimize.pod
febootstrap-minimize.sh
febootstrap-run.pod
febootstrap-run.sh
febootstrap-to-initramfs.pod
febootstrap-to-initramfs.sh
febootstrap-to-supermin.pod
febootstrap-to-supermin.sh
febootstrap.pod
febootstrap.sh

README

febootstrap - Bootstrap a basic Fedora system
by Richard W.M. Jones (rjones@redhat.com)
http://people.redhat.com/~rjones/febootstrap
----------------------------------------------------------------------

febootstrap is a Fedora equivalent to Debian's debootstrap.  You can
use it to create a basic Fedora filesystem.

There are currently some restrictions compared to debootstrap.

For instructions, restrictions, examples etc. please read the manpage
febootstrap(8).

Requirements
------------

  fakeroot
    - Tested with version 1.11.

  fakechroot >= 2.9 or 2.8 + patch
    - **** NB. KNOWN NOT TO WORK WITH 2.8 *****  You MUST apply
      the patch 'fakechroot-2.8-relchroot.patch' to the fakechroot
      sources and recompile.  Hopefully this patch will be included
      in future versions of fakechroot.

  yum
    - Tested with version 3.2 (works best with 3.2.21 or above)
    - Needs network access to a Fedora repository, or a local
      Fedora mirror.

  perldoc
    - This is just used to generate the manpage.

  bash

  gcc

  qemu
    - If you want to test-run your systems.

  libext2fs
  /sbin/mke2fs
    - These are part of e2fsprogs.

Building and installing
-----------------------

  ./configure
  make
  sudo make install

Note, if you want to run the scripts locally without installing,
you have to set the $PATH to the current directory, ie:

  PATH=$(pwd):$PATH
  febootstrap [...]

Debugging
---------

If you get segfaults while running febootstrap or errors in the %post
scripts, these are often caused by some incompatibility in the
emulation provided by fakeroot/fakechroot.  You can track them down by
running the yum command explicitly.  Try:

  fakeroot fakechroot -s \
    yum -y -c /tmp/repo \
      --disablerepo=\* --enablerepo=febootstrap \
      --noplugins --nogpgcheck \
      --installroot=/tmp/root \
      install "@Core"

where /tmp/repo would be a file like this (change repo and arch
parameters as appropriate):

  [febootstrap]
  name=febootstrap
  failovermethod=priority
  enabled=1
  gpgcheck=0
  mirrorlist=http://mirrors.fedoraproject.org/mirrorlist?repo=rawhide&arch=x86_64

You can insert gdb in the appropriate place in the fakeroot /
fakechroot / yum command.

Feedback and bugs
-----------------

Send feedback to rjones@redhat.com.  You can file bugs in
http://bugzilla.redhat.com/
Something went wrong with that request. Please try again.