1 files changed, 58 insertions, 0 deletions
diff --git a/env.md b/env.md
new file mode 100644
index 0000000..cf5508c
--- /dev/null
+++ b/env.md
@@ -0,0 +1,58 @@
+Environment
+===========
+
+Build environment creation
+--------------------------
+
+The following steps needs to be run just once for each arch and distro version.
+
+### Setup cowbuilder chroots
+
+This is the recommended method:
+
+    sudo mkdir -p /var/cache/pbuilder/sid-amd64
+    sudo -E cowbuilder --create
+
+    sudo mkdir -p /var/cache/pbuilder/jessie-amd64
+    sudo -E DIST=jessie cowbuilder --create
+
+### Setup pbuilder chroots
+
+If you want to setup directly using `pbuilder`:
+
+    git-pbuilder create
+    DIST=jessie git-pbuilder
+
+### Compatibility with git-buildpackage
+
+This is a workaround while we don't find a cleaner way to fix
+[this issue](http://ramblingfoo.blogspot.com.br/2012/10/howto-sudo-cowbuilder-git-buildpackage.html)
+with `git-buildpackage` not getting `~/.pbuilderrc` from the local user:
+
+    ( cd /var/cache/pbuilder/ && sudo ln -s sid-amd64/base.cow )
+
+External repo integration
+-------------------------
+
+If your package storage lives elsewhere, make a symlink like this:
+
+    (
+      cd /var/cache/pbuilder/jessie-amd64 && \
+      sudo rm -rf result                  && \
+      sudo ln -s /var/data/distros/debian/packages/build-area/jessie-amd64 result
+    )
+
+Environment maintenance
+-----------------------
+
+These steps should be run once in a while to ensure we have an up to date packaging environment.
+
+### Pbuilder
+
+    DIST=sid    git-pbuilder update
+    DIST=jessie git-pbuilder update --override-config
+
+### Cowbuilder
+
+    DIST=sid    sudo -E cowbuilder --update
+    DIST=jessie sudo -E cowbuilder --update --override-config