summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEdward Cragg <edward.cragg@codethink.co.uk>2016-03-27 12:58:25 +0100
committerEdward Cragg <edward.cragg@codethink.co.uk>2016-03-30 03:21:41 +0100
commit3b58eacabb4db2d9d51248085715ebc86c615dc9 (patch)
tree5307982eee6087c476465bd4424c85ba96284dc0
parent6acbc746abcf9fcae766cf8521ce488b1c898fcc (diff)
downloadmorph-baserock/edcragg/independent-build-wip.tar.gz
README: Add Baserock-independent build instructionsbaserock/edcragg/independent-build-wip
Update README with details on how to run morph independently from Baserock. Change-Id: Ic1cb58dddb43599017b41fa1126a49edb243a89a
-rw-r--r--README41
1 files changed, 41 insertions, 0 deletions
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
-----------------