diff --git a/website/content/docs/configuration/controller.mdx b/website/content/docs/configuration/controller.mdx
index 6428ff89c5..70ff612bdd 100644
--- a/website/content/docs/configuration/controller.mdx
+++ b/website/content/docs/configuration/controller.mdx
@@ -24,4 +24,10 @@ controller {
 
 - `description` - Specifies a friendly description of this controller.
 
-- `database` - Configuration block with one parameter, `url`, for connecting to Postgres.
+- `database` - Configuration block with two valid parameters for connecting to Postgres:
+    - `url` - Configures the URL for connecting to Postgres
+    - `migration_url` - Can be used to specify a different URL for the migrations, as that 
+       usually requires higher priviledges.
+
+    Either can refer to a file on disk (file://) from which a URL will be read; an env
+    var (env://) from which the URL will be read; or a direct database URL (postgres://).