From e0111eded4cc0ad0825586574478f44cf3b353cb Mon Sep 17 00:00:00 2001
From: Laszlo Fogas <laszlo@laszlo.cloud>
Date: Wed, 20 May 2020 06:58:21 +0200
Subject: [PATCH] Documenting flag

---
 docs/docs/server-setup.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/docs/server-setup.md b/docs/docs/server-setup.md
index 5367af789..453e5557e 100644
--- a/docs/docs/server-setup.md
+++ b/docs/docs/server-setup.md
@@ -354,3 +354,24 @@ spec:
         securityContext:
           privileged: true
 ```
+
+## Filtering repositories
+
+Woodpecker operates with the user's OAuth permission. Due to the coarse permission handling of Github, you may end up syncing more repos into Woodpecker than preferred.
+
+Use the `DRONE_REPO_OWNERS` variable to filter which Github user's repos should be synced only. You typically want to put here your company's Github name.
+
+```diff
+services:
+  woodpecker-server:
+    image: laszlocloud/woodpecker-server:v0.9.0
+    environment:
+      - DRONE_OPEN=true
+      - DRONE_ORGS=dolores,dogpatch
++     - DRONE_REPO_OWNERS=mycompany,mycompanyossgithubuser
+      - DRONE_HOST=${DRONE_HOST}
+      - DRONE_GITHUB=true
+      - DRONE_GITHUB_CLIENT=${DRONE_GITHUB_CLIENT}
+      - DRONE_GITHUB_SECRET=${DRONE_GITHUB_SECRET}
+      - DRONE_SECRET=${DRONE_SECRET}
+```