## This help page is incomplete

### Introduction

This module allows you to configure the BIND (Berkeley Internet Name Daemon) DNS server installed on this machine. The DNS server is responsible for converting hostnames like www.foo.com into IP addresses like 10.1.2.3, and IP addresses into hostnames.

### DNS Basics

Each DNS server manages a number of forward and reverse domains. A forward domain is something like foo.com, and a reverse domain like 204.165.66. For each domain, the DNS server can either be the primary server (the original source of data for the domain), or a secondary server (a backup source for the domain).

Forward Domains
  If your DNS server manages a forward domain like foo.com, then it will be able to answer requests for hostnames within this domain. For domains for which this server is the primary, you can use this module to add hosts (and other records) to the domain. For secondary domains, you can specify the primary server(s) to download host information from.

Reverse Domains
  Reverse domains map IP addresses (like 203.165.66.77) into hostnames (like www.foo.com). A reverse domain provides hostnames for all the IP addresses in a network (like 203.165.66). For domains for which this server is the primary, this module allows you to add IP to hostname records to the domain. For secondary domains, you can specify the DNS server(s) to download IP address mappings from.

### Setting up the DNS Server

If your system already has a running BIND DNS server, then you can ignore this section. However, if the Webmin detects that the primary DNS server configuration file (usually `/etc/named.boot`) is missing from your system, it assumes that the server has not yet been setup.

For normal internet use, a DNS server has to have a list of the root nameservers so that it can answer DNS queries that are outside its domains. If your server is not setup, Webmin can:

1. Download this list from the internic FTP server at `rs.internic.net`. Assuming the host Webmin in being run on is connected to the internet and is not blocked by any firewall, this is the best option.

2. Use a copy of the list that is distributed with Webmin. Because the root nameservers do not change very often, this should work fine.

3. Setup the nameserver for 'internal' use only. If you are on network that is not connected to the internet, then this is the option you want.

### Creating a Primary Domain

To create a new primary domain, fill in the form under Add a new primary domain on the DNS Server page. The meaning of the fields are:

- Mapping
  Determines if this is a forward or reverse domain

- Domain/Net
  For forward domains, the domain to be added (like `foo.com`). For reverse domains, the IP network to be added (like `203.123.221`).

- Filename
  The name of the file in which to store the domain information. If you leave this field blank, a suitable filename is automatically generated.

- Contact email
  Each DNS domain must have an associated email address, which should be the person responsible for the domain.

- Nameserver
  This must contain the fully qualified name of the nameserver responsible for this domain. This will almost always be the name of the host you are running Webmin on.

### Creating a Secondary Domain

### Editing a Primary Domain

### Editing Domain Records

Return to module