boundary/website/content/docs/configuration/controller.mdx

---
layout: docs
page_title: Controller - Configuration
sidebar_title: controller
description: |-
  The controller stanza configures controller-specifc parameters.
---

# `controller` Stanza

The `controller` stanza configures Boundary controller-specific parameters.

```hcl
controller {
  name = "example-controller"
  description = "An example controller"
  database {
    url = "postgresql://<username>:<password>@10.0.0.1:5432/<database_name>"
  }
}
```

- `name` - Specifies a unique name of this controller within the Boundary controller cluster.

- `description` - Specifies a friendly description of this controller.

- `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://).