README.md: Add multi-site configuration details.

1 files changed, 35 insertions, 0 deletions

diff --git a/README.md b/README.md
index 9045139..51cebdf 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,41 @@ The syntax for doing this is simple and easy to manage via the configuration fil
     
     teachers = teacher-printer
 
+## Using a Single Configuration for Multiple Sites
+
+You can manage multiple sites (e.g. schools, customers, networks) in one
+``standardskriver.cfg`` file and deploy that configuration file across the
+managed sites (very useful when deploying diskless workstation images to multiple
+sites).
+
+Each site needs to be given a unique name (e.g. SCHOOL-01, SCHOOL-02,
+etc.). This site ID goes into an extra file:
+``/etc/standardskriver.site``. This file is optional. The first line is
+read from this file, gets sanitized and the outcome is the site ID.
+
+In ``/etc/standardskriver.cfg you can then put sections like:
+
+    [machine.SCHOOL-01]
+    # special rules for SCHOOL-01
+    10.1.2.3 = school-01-admin-printer
+
+    [machine.SCHOOL-02]
+    10.3.6.3 = school-02-admin-printer
+
+    10.0.0.0/8 = main-printer
+
+The same configuration scheme is possible for POSIX groups:
+
+    [groups.SCHOOL-01]
+    teachers = school-01-teacher-printer
+
+    [groups.SCHOOL-02]
+    teachers = school-02-teacher-printer
+
+    [groups]
+    students = students-printer
+
+
 ## License and Copyright
 
 The Standard Skriver Tool is licensed under the GPL-2+ license.