home-assistant.github.io/source/_addons/dnsmasq.markdown
2017-07-21 23:56:37 +02:00

36 lines
1.2 KiB
Markdown

---
layout: page
title: "Dnsmasq"
description: "A simple DNS server."
date: 2017-04-30 13:28
sidebar: true
comments: false
sharing: true
footer: true
---
Setup and manage a [Dnsmasq](http://thekelleys.org.uk/dnsmasq/doc.html) DNS server. This allows you to manipulate DNS requests. For example, you can have your Home Assistant domain resolve with an internal address inside your network.
<p class='note info'>
`interface` options are for resinos based installation. On other system you can set it to `""`, for listen on every interface.
</p>
```json
{
"defaults": ["8.8.8.8", "8.8.4.4"],
"forwards": [
{"domain": "mystuff.local", "server": "192.168.1.40"}
],
"hosts": [
{"host": "home.mydomain.io", "ip": "192.168.1.10"}
],
"interface": "eth1"
}
```
Configuration variables:
- **defaults** (*Required*): A list of dns server to forward default requests.
- **forwards** (*Optional*): A list of domains that will forward to a specific server.
- **hosts** (*Optional*): A list of hosts to resolve it static.
- **interface** (*Optional*): If a interface is set, it listen only on this interface. Need to set for resinos. Normaly is `eth0` for ethernet wired connection and `wlan0` for wireless connection.