From 630543dcf829c94c9bd2691ee53f227bc61afe8c Mon Sep 17 00:00:00 2001
From: Jernej Jakob <jernej.jakob@gmail.com>
Date: Fri, 13 Dec 2019 02:53:07 +0100
Subject: README: add note about building a package from a custom repo (fork)

---
 README.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

(limited to 'README.md')

diff --git a/README.md b/README.md
index bc0b616a..419235d7 100644
--- a/README.md
+++ b/README.md
@@ -253,6 +253,30 @@ building `vyos-strongswan` and can be ignored on other packages.
 **NOTE:** `vyos-strongswan` will only compile on a Linux system, running on macOS
 or Windows might result in a unittest deadlock (it never exits).
 
+#### Building single packages from your own repositories
+
+You can also build packages that are not from the default git repositories,
+for example from your own forks of the official vyos repositories.
+
+First create a directory "packages" at the top level of the vyos-build repository
+and clone your package into it (creating a subdirectory with the package contents).
+Then checkout the correct branch or commit you want to build before building the package.
+
+```bash
+$ mkdir packages
+$ cd packages
+$ git clone git@github.com:myname/vyos-1x.git
+$ cd vyos-1x
+$ git checkout equuleus
+$ cd ../..
+$ docker run --rm -it -v $(pwd):/vyos -w /vyos/packages/PACKAGENAME \
+             --sysctl net.ipv6.conf.lo.disable_ipv6=0 \
+             vyos-builder scripts/build-packages -b vyos-1x
+```
+
+**NOTE:** you need to git pull manually after you commit to the remote and before rebuilding,
+the local repository won't be updated automatically.
+
 # Development process
 
 ## Git branches
-- 
cgit v1.2.3