From Fedora Project Wiki

(Hope that helps)
m (uploading revision that User:Sdz and I hacked up in etherpad last night, still in progress)
Line 6: Line 6:
== Introduction ==
== Introduction ==


This page explains how to make a custom-content Live CD or DVD on Fedora-based systems including derived distributions such as RHEL, CentOS and others.  
This page explains how to make a custom-content Live CD or DVD on Fedora-based systems including derived distributions such as RHEL, CentOS and others.  


If you simply want to burn a pre-made ISO to a disc, visit http://fedoraproject.org/en/get-fedora to download a LiveCD or LiveDVD, then see the [http://docs.fedoraproject.org/install-guide/ install guide] or [http://docs.fedoraproject.org/readme-burning-isos/ burning how-to] for further instructions.
If you simply want to burn a pre-made ISO to a disc, visit http://fedoraproject.org/en/get-fedora to download a LiveCD or LiveDVD, then see the [http://docs.fedoraproject.org/install-guide/ install guide] or [http://docs.fedoraproject.org/readme-burning-isos/ burning how-to] for further instructions.


See the [[FedoraLiveCD | project wiki]] for more details. Discussion of this project takes places at http://admin.fedoraproject.org/mailman/listinfo/livecd.
See the [[FedoraLiveCD | project wiki]] for more details. Discussion of this project takes places at http://admin.fedoraproject.org/mailman/listinfo/livecd.


This project and its source files are licensed under the GPLv2 license. See the file COPYING for details.
== Instructions ==
 
The basic workflow for creating a  remix is:
 
#  Create a kickstart file that specifies the packages you want installed  on your remix, along with special settings you want to tweak.
#  Run that  kickstart file through livecd-creator, which will pull in the packages  and compose an .iso, which you can then burn to CD.
 
...that's it! We will walk you through these steps  below.


== Instructions ==
=== Choose a kickstart file as a base for your remix ===
 
Kickstart files are configuration files. They contain settings for tools, such as:
 
* [https://fedorahosted.org/pungi/ pungi] (for the creation of install disks),
* [http://git.fedoraproject.org/git/livecd livecd-creator] (for the creation of  live images)
* [[Anaconda|anaconda]] (the built-in installer)
 
You can see examples of kickstart  files in the [http://git.fedorahosted.org/git/?p=spin-kickstarts.git spin-kickstart repository]. These are the kickstart files for the  spins displayed at http://spins.fedoraproject.org.
 
Since we are creating a LiveCD, we  want a kickstart file for livecd-creator. Chances are good that an  existing LiveCD kickstart already contains most of the things we need,  like a graphical dekstop environment, drivers, and the ability to make live images  persistent (for installation on a liveUSB rather than a liveCD).  Therefore, in order to avoid reinventing the wheel, we're going to start  by picking an existing kickstart for a LiveCD to base our remix's  kickstart from.
 
There  are currently two kickstart files that provide the main configuration  to setup the live images.  Pick one of these two:


=== Choose a kickstart file to base your spin on ===
* [http://git.fedorahosted.org/git/?p=spin-kickstarts.git;a=blob;f=fedora-live-base.ks;hb=HEAD fedora-live-base.ks]: The file used for most composes. If you don't know where to start,  this is a good default choice.
* [http://git.fedorahosted.org/git/?p=spin-kickstarts.git;a=blob;f=fedora-live-mini.ks;hb=HEAD fedora-live-mini.ks]: A trimmed-down edition of the first  file, mostly used by the Mini SIG for size-sensitive purposes. If space-saving is a primary  concern, choose this one.


Kickstart files are... (find description here)
<what  do you do once you've picked one of the two .ks files? mmm,  customization guide>... maybe it'd just make sense to generalize the customization guide? well,  we got probably a little too far here already for that.
*reading*


=== Create a kickstart file ===
=== Create a kickstart file ===


Take template.
# Create an empty text document in  the editor of your choice.
# Import the base kickstart file you  chose above:


Add things to it.
<code>%include  fedora-live-base.ks</code>


Process I don't understand.
# Create the package manifest section  and add your favorite packages:


Example goes here later.
<code>
%packages
foo
baz
bar
%end
</code>


: To base a kickstart on your own system's installation, become the root user and look for the log in that user's home directory, at ''/root/anaconda-ks.cfg''.
# Congrats -- you're done!
: You can also install {{package|system-config-kickstart}} to create a kickstart file from scratch.
: A reference for kickstart files and their content is available in the Anaconda documentation [[Anaconda/Kickstart | here]].


=== Build the image ===
=== Build the image ===


You'll need the livecd-creator tool.
You'll need the livecd-creator tool. Go and install it as root:
 
* yum install livecd-creator


  sudo yum install livecd-creator
The build process will take some time, as well as space and bandwidth.


=== Adjust the image ===
=== Adjust the image ===


ZOMG it's too big! How to cut stuff. See [[#Release management]] for more notes. (make that section)
ZOMG it's too big! How to cut stuff. See [[#Release management]] for more notes. (make that section)


=== Distribute the image ===
=== Distribute the image ===


Now you have an .iso. What do you do with it?
Now you have an .iso. What do you do with it?


== Resources ==
== Resources ==

Revision as of 14:10, 17 June 2010


Introduction

This page explains how to make a custom-content Live CD or DVD on Fedora-based systems including derived distributions such as RHEL, CentOS and others.

If you simply want to burn a pre-made ISO to a disc, visit http://fedoraproject.org/en/get-fedora to download a LiveCD or LiveDVD, then see the install guide or burning how-to for further instructions.

See the project wiki for more details. Discussion of this project takes places at http://admin.fedoraproject.org/mailman/listinfo/livecd.

Instructions

The basic workflow for creating a remix is:

  1. Create a kickstart file that specifies the packages you want installed on your remix, along with special settings you want to tweak.
  2. Run that kickstart file through livecd-creator, which will pull in the packages and compose an .iso, which you can then burn to CD.

...that's it! We will walk you through these steps below.

Choose a kickstart file as a base for your remix

Kickstart files are configuration files. They contain settings for tools, such as:

You can see examples of kickstart files in the spin-kickstart repository. These are the kickstart files for the spins displayed at http://spins.fedoraproject.org.

Since we are creating a LiveCD, we want a kickstart file for livecd-creator. Chances are good that an existing LiveCD kickstart already contains most of the things we need, like a graphical dekstop environment, drivers, and the ability to make live images persistent (for installation on a liveUSB rather than a liveCD). Therefore, in order to avoid reinventing the wheel, we're going to start by picking an existing kickstart for a LiveCD to base our remix's kickstart from.

There are currently two kickstart files that provide the main configuration to setup the live images. Pick one of these two:

  • fedora-live-base.ks: The file used for most composes. If you don't know where to start, this is a good default choice.
  • fedora-live-mini.ks: A trimmed-down edition of the first file, mostly used by the Mini SIG for size-sensitive purposes. If space-saving is a primary concern, choose this one.

<what do you do once you've picked one of the two .ks files? mmm, customization guide>... maybe it'd just make sense to generalize the customization guide? well, we got probably a little too far here already for that.

  • reading*

Create a kickstart file

  1. Create an empty text document in the editor of your choice.
  2. Import the base kickstart file you chose above:

%include fedora-live-base.ks

  1. Create the package manifest section and add your favorite packages:

%packages foo baz bar %end

  1. Congrats -- you're done!

Build the image

You'll need the livecd-creator tool. Go and install it as root:

  • yum install livecd-creator

The build process will take some time, as well as space and bandwidth.

Adjust the image

ZOMG it's too big! How to cut stuff. See #Release management for more notes. (make that section)

Distribute the image

Now you have an .iso. What do you do with it?

Resources