Welcome to NanoBSD, [http://www.freebsd.org/doc/en/articles/nanobsd/index.html FreeBSD default method] for installing [http://www.freebsd.org FreeBSD] on embedded devices, like [http://www.soekris.com Soekris] and others. The manual described below is (loosely) based on the [source:"doc/Concept v0.3.pdf" Concept plan of Tim Baas], but also consists of many hints by [http://www.freebsd.org/doc/en/articles/nanobsd/index.html official 'Introduction to NanoBSD' manual]

= Have to remember links =
 * [http://people.freebsd.org/~phk/nanobsd/soekris_4x26/make.soekris_4x26.conf]
 * [http://www.paeps.cx/weblog/2005/Jul/10]

= Procedure =

Please note to find the supporting files in the subdirectory [source:nanobsd]

= Build environment =
 
 Get yourself a fresh freebsd host with ports and subversion installed
 1. Run the basic CD installer of 7.x. Manual tested with 7.1-RELEASE (real basic install will fit our needs). Installing FreeBSD is not scope of the document, take a look into [http://www.freebsd.org/doc/en/books/handbook/install.html the FreeBSD handbook Chapter 2 Installing FreeBSD] if you do not know the details.
 1. get latest sources {{{ csup -g -L 2 -h cvsup.nl.freebsd.org /usr/share/examples/cvsup/standard-supfile }}}
 1. install subversion {{{ pkg_add -r subversion }}}
 1. fetch ports {{{ portsnap fetch extract }}}
 1. OPTIONAL, every developer has his own preferences, these are mine ;-) {{{ pkg_add -r vim-lite sudo screen }}}

= Introduction =
First download the environment and run initial build
{{{
$ setenv R /root/nanobsd
$ svn checkout http://svn.wirelessleiden.nl/svn/projects/iris/nanobsd $R
$ cd $R
$ sh /usr/src/tools/tools/nanobsd/nanobsd.sh -c $R/cfg/nanobsd.wleiden
}}}

Even the little script got flags, check the output of {{{sh /usr/src/tools/tools/nanobsd/nanobsd.sh -h}}}
{{{
-b suppress builds (both kernel and world)
-k suppress buildkernel
-w suppress buildworld
-c specify config file
}}}


XXX: TODO describe procedure

= WL specific =
stumber, hidden gem maybe /usr/src/tools/tools/net80211/stumber

= Hints =
 * You could always decide to install your FreeBSD base instance into a [http://www.freebsd.org/doc/en/books/handbook/virtualization-guest.html virtual envirionment]
 * {{{cvsup.nl.freebsd.org}}} is the local dutch cvsup mirror, replace `nl` with your proper country code
 * It seems tempting to follow {{{/usr/share/examples/cvsup/stable-supfile}}} instead of {{{/usr/share/examples/cvsup/standard-supfile}}} please __DO NOT__ unless your like big trouble as stable-supfile is the stable __DEVELOPMENT__ branch e.g. upcoming stable.
= Comments, questions or remarks? = 
Feel free to edit this page or [mailto:techniek@lijst.wirelessleiden.nl?subject=NanoBSD%20odefactory%improvement send an email] to our [http://lijst.wirelessleiden.nl/mailman/listinfo/techniek techniek mailinglist]