diff --git a/docs/auth/oauth2-proxy/provider.md b/docs/auth/oauth2-proxy/provider.md
index 9c8f681138..5cff655c02 100644
--- a/docs/auth/oauth2-proxy/provider.md
+++ b/docs/auth/oauth2-proxy/provider.md
@@ -20,8 +20,10 @@ The provider configuration can be added to your `app-config.yaml` under the root
 
 ```yaml title="app-config.yaml"
 auth:
+  environment: development
   providers:
-    oauth2Proxy: {}
+    oauth2Proxy:
+      development: {}
 ```
 
 Right now no configuration options are supported, but the empty object is needed
@@ -58,6 +60,8 @@ providerFactories: {
 },
 ```
 
+[An example on how to sign a user in without a matching user](https://github.com/backstage/backstage/blob/master/packages/backend/src/plugins/auth.ts)
+
 ## Adding the provider to the Backstage frontend
 
 It is recommended to use the `ProxiedSignInPage` for this provider, which is