From 3b58eacabb4db2d9d51248085715ebc86c615dc9 Mon Sep 17 00:00:00 2001 From: Edward Cragg Date: Sun, 27 Mar 2016 12:58:25 +0100 Subject: README: Add Baserock-independent build instructions Update README with details on how to run morph independently from Baserock. Change-Id: Ic1cb58dddb43599017b41fa1126a49edb243a89a --- README | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) diff --git a/README b/README index 41a7a37d..63810ad6 100644 --- a/README +++ b/README @@ -54,6 +54,47 @@ something like this: All of the above settings apart from `log` are the defaults, so may be omitted. +Running `morph` outside Baserock +-------------------------------- + +It used to be the case that `morph` had to be run from within an existing +Baserock system, however it is now possible to run `morph` from a general +Linux host system; this has currently been demonstrated to work on Debian, +Ubuntu and Fedora on x86_64, Ubuntu on 64-bit little-endian ARMv8, and Debian +on little-endian ARMv7. + +* Install dependencies (on Debian-like systems) + + sudo apt-get install linux-user-chroot python-pip build-essential git m4 + +* Install dependencies (on Fedora systems) + + sudo dnf install linux-user-chroot python-pip git m4 + sudo dnf install make automake gcc gcc-c++ kernel-devel + +* Install dependencies (all) + + sudo pip install fs pylru jsonschema pyyaml + +* Set-up + + sudo git config --global user.name 'Your Name' + sudo git config --global user.email 'your.email@address.org' + +* Clone sources + + git clone git://git.baserock.org/baserock/baserock/definitions.git + git clone git://git.baserock.org/baserock/baserock/morph.git + cd definitions + +* Start a build + + sudo ../morph/morph build systems/base-system-x86_64-generic.morph + +You may optionally create a `/root/.morph.conf` configuration in the same way +as above to configure `morph`, for example to add a log file. + + Build environment ----------------- -- cgit v1.2.1