summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-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
-----------------