chore: docs: document CODERD_BITBUCKET_CONSUMER_KEY (#1087)

johnstcn · web-flow · commit 884b1267bae2 · 2022-08-19T11:53:20.000+01:00
diff --git a/admin/git.md b/admin/git.md
@@ -100,7 +100,7 @@ response received** error, click **Continue** to ignore it.
 For your newly created Application Link, provide the following values as your
 **Incoming Authentication** properties:
 
-- **Consumer Key**: `Coder`
+- **Consumer Key**: `Coder` (or the value of `CODERD_BITBUCKET_CONSUMER_KEY`)
 - **Consumer Name**: `Coder`
 - **Public Key**: Your public key (available from the Coder Admin Configuration
   page)
@@ -109,3 +109,19 @@ Then, in Coder, provide a **Name** for your app, your **URL**, and, optionally,
 a **Description**.
 
 When done, click **Save**.
+
+> 💡 By default, Coder sets the Bitbucket Consumer Key to `Coder`. This can
+> cause issues when attempting to link multiple Coder instances to a single
+> Bitbucket server. In this case, you can override the Bitbucket Consumer Key by
+> setting the environment variable `CODERD_BITBUCKET_CONSUMER_KEY` to a unique
+> value for each Coder deployment. Here's an example of how to set this in your
+> Helm values:
+>
+> ```yaml
+> coderd:
+>   [...]
+>   extraEnvs:
+>     [...]
+>     - name: CODERD_BITBUCKET_CONSUMER_KEY
+>       value: XXX
+> ```
