From dcf87fd1f2c180045f16c8fac3234ff982ce38e3 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. https://storyboard.baserock.org/#!/story/88 Change-Id: Ic1cb58dddb43599017b41fa1126a49edb243a89a --- README | 46 +++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 45 insertions(+), 1 deletion(-) diff --git a/README b/README index 41a7a37d..0da504b6 100644 --- a/README +++ b/README @@ -54,6 +54,50 @@ 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, and Ubuntu on 64-bit little-endian ARMv8. + +Morph needs to be run as root user. As such, system configurations required to +run `morph` independently, and which are tied to a particular user, must also +be applied to root. + +* 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 --user 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 ----------------- @@ -92,7 +136,7 @@ Run the checks before submitting a patch, please. Legalese -------- -Copyright (C) 2011-2015 Codethink Limited +Copyright (C) 2011-2016 Codethink Limited This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by -- cgit v1.2.1