| title: | Customizing controller |
|---|---|
| description: | Learn how to tune custom Deis settings. |
The following settings are tunable for the :ref:`controller` component.
Requires: :ref:`controller <controller_settings>`, :ref:`cache <cache_settings>`, :ref:`database <database_settings>`, :ref:`registry <registry_settings>`
Required by: :ref:`router <router_settings>`
Considerations: must live on the same host as logger (see #985)
The following etcd keys are set by the controller component, typically in its /bin/boot script.
| setting | description |
|---|---|
| /deis/controller/host | IP address of the host running controller |
| /deis/controller/port | port used by the controller service (default: 8000) |
| /deis/controller/protocol | protocol for controller (default: http) |
| /deis/controller/secretKey | used for secrets (default: randomly generated) |
| /deis/controller/builderKey | used by builder to authenticate with the controller (default: randomly generated) |
| /deis/builder/users/* | stores user SSH keys (used by builder) |
| /deis/domains/* | domain configuration for applications (used by router) |
The following etcd keys are used by the controller component.
| setting | description |
|---|---|
| /deis/controller/registrationEnabled | enable registration for new Deis users (default: true) |
| /deis/controller/webEnabled | enable controller web UI (default: false) |
| /deis/cache/host | host of the cache component (set by cache) |
| /deis/cache/port | port of the cache component (set by cache) |
| /deis/database/host | host of the database component (set by database) |
| /deis/database/port | port of the database component (set by database) |
| /deis/database/engine | database engine (set by database) |
| /deis/database/name | database name (set by database) |
| /deis/database/user | database user (set by database) |
| /deis/database/password | database password (set by database) |
| /deis/registry/host | host of the registry component (set by registry) |
| /deis/registry/port | port of the registry component (set by registry) |
| /deis/registry/protocol | protocol of the registry component (set by registry) |
You can use a custom Docker image for the controller component instead of the image supplied with Deis:
$ deisctl config controller set image myaccount/myimage:latestThis will pull the image from the public Docker registry. You can also pull from a private registry:
$ deisctl config controller set image registry.mydomain.org:5000/myaccount/myimage:latestBe sure that your custom image functions in the same way as the stock controller image shipped with Deis. Specifically, ensure that it sets and reads appropriate etcd keys.