From d5a6b1bd143fd387f06e8931c2d15f1d3e84a978 Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen <paulus@paulusschoutsen.nl>
Date: Mon, 25 Sep 2017 00:28:04 -0700
Subject: [PATCH] Add DuckDNS component (#3429)

* Add DuckDNS component

* Add period and an additional line break
---
 source/_addons/duckdns.markdown     |  4 ++--
 source/_components/duckdns.markdown | 36 +++++++++++++++++++++++++++++
 2 files changed, 38 insertions(+), 2 deletions(-)
 create mode 100644 source/_components/duckdns.markdown

diff --git a/source/_addons/duckdns.markdown b/source/_addons/duckdns.markdown
index 908a297c744..e4299f15115 100644
--- a/source/_addons/duckdns.markdown
+++ b/source/_addons/duckdns.markdown
@@ -1,6 +1,6 @@
 ---
 layout: page
-title: "Duck DNS"
+title: "DuckDNS"
 description: "Automatically update your Duck DNS IP address."
 date: 2017-04-30 13:28
 sidebar: true
@@ -10,7 +10,7 @@ footer: true
 featured: true
 ---
 
-[Duck DNS](https://duckdns.org/) is a free service which will point a DNS (sub domains of duckdns.org) to an IP of your choice.
+[Duck DNS](https://duckdns.org/) is a free dynamic DNS service. Using this service you can have a custom domainname under duckdns.org point at your home computer.
 
 ```json
 {
diff --git a/source/_components/duckdns.markdown b/source/_components/duckdns.markdown
new file mode 100644
index 00000000000..93caf14341b
--- /dev/null
+++ b/source/_components/duckdns.markdown
@@ -0,0 +1,36 @@
+---
+layout: page
+title: "DuckDNS"
+description: "Keep your computer registered with the DuckDNS dynamic DNS."
+date: 2017-09-23 07:08
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: duckdns.png
+ha_category: Utility
+featured: false
+ha_release: 0.55
+---
+
+With the DuckDNS component you can keep your DuckDNS record up to date. DuckDNS is a free dynamic DNS service that allows you to point a subdomain under `duckdns.org` at your computer.
+
+To use the component in your installation, add the following to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+duckdns:
+  domain: mysubdomain
+  access_token: abcdefgh
+```
+
+{% configuration binary_sensor.template %}
+  domain:
+    description: Your duckdns subdomain (without the `.duckdns.org` suffix).
+    required: true
+    type: string
+  access_token:
+    description: Your DuckDNS access token. Log in to the site to get one.
+    required: true
+    type: string
+{% endconfiguration %}