Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sameersbn/docker-bind

Dockerize BIND DNS server with webmin for DNS administration
https://github.com/sameersbn/docker-bind

bind containers dns docker docker-image

Last synced: 25 days ago
JSON representation

Dockerize BIND DNS server with webmin for DNS administration

Awesome Lists containing this project

README 

        
[![Circle CI](https://circleci.com/gh/sameersbn/docker-bind.svg?style=shield)](https://circleci.com/gh/sameersbn/docker-bind) [![Docker Repository on Quay.io](https://quay.io/repository/sameersbn/bind/status "Docker Repository on Quay.io")](https://quay.io/repository/sameersbn/bind)



# sameersbn/bind:9.16.1-20200524



- [Introduction](#introduction)

  - [Contributing](#contributing)

  - [Issues](#issues)

- [Getting started](#getting-started)

  - [Installation](#installation)

  - [Quickstart](#quickstart)

  - [Command-line arguments](#command-line-arguments)

  - [Persistence](#persistence)

- [Maintenance](#maintenance)

  - [Upgrading](#upgrading)

  - [Shell Access](#shell-access)



# Introduction



`Dockerfile` to create a [Docker](https://www.docker.com/) container image for [BIND](https://www.isc.org/downloads/bind/) DNS server bundled with the [Webmin](http://www.webmin.com/) interface.



BIND is open source software that implements the Domain Name System (DNS) protocols for the Internet. It is a reference implementation of those protocols, but it is also production-grade software, suitable for use in high-volume and high-reliability applications.



## Contributing



If you find this image useful here's how you can help:



- Send a pull request with your awesome features and bug fixes

- Help users resolve their [issues](../../issues?q=is%3Aopen+is%3Aissue).

- Support the development of this image with a [donation](http://www.damagehead.com/donate/)



## Issues



Before reporting your issue please try updating Docker to the latest version and check if it resolves the issue. Refer to the Docker [installation guide](https://docs.docker.com/installation) for instructions.



SELinux users should try disabling SELinux using the command `setenforce 0` to see if it resolves the issue.



If the above recommendations do not help then [report your issue](../../issues/new) along with the following information:



- Output of the `docker version` and `docker info` commands

- The `docker run` command or `docker-compose.yml` used to start the image. Mask out the sensitive bits.

- Please state if you are using [Boot2Docker](http://www.boot2docker.io), [VirtualBox](https://www.virtualbox.org), etc.



# Getting started



## Installation



Automated builds of the image are available on [Dockerhub](https://hub.docker.com/r/sameersbn/bind) and is the recommended method of installation.



> **Note**: Builds are also available on [Quay.io](https://quay.io/repository/sameersbn/bind)



```bash

docker pull sameersbn/bind:9.16.1-20200524

```



Alternatively you can build the image yourself.



```bash

docker build -t sameersbn/bind github.com/sameersbn/docker-bind

```



## Quickstart



Start BIND using:



```bash

docker run --name bind -d --restart=always \

  --publish 53:53/tcp --publish 53:53/udp --publish 10000:10000/tcp \

  --volume /srv/docker/bind:/data \

  sameersbn/bind:9.16.1-20200524

```



*Alternatively, you can use the sample [docker-compose.yml](docker-compose.yml) file to start the container using [Docker Compose](https://docs.docker.com/compose/)*



When the container is started the [Webmin](http://www.webmin.com/) service is also started and is accessible from the web browser at https://localhost:10000. Login to Webmin with the username `root` and password `password`. Specify `--env ROOT_PASSWORD=secretpassword` on the `docker run` command to set a password of your choosing.



The launch of Webmin can be disabled by adding `--env WEBMIN_ENABLED=false` to the `docker run` command. Note that the `ROOT_PASSWORD` parameter has no effect when the launch of Webmin is disabled.



Read the blog post [Deploying a DNS Server using Docker](http://www.damagehead.com/blog/2015/04/28/deploying-a-dns-server-using-docker/) for an example use case.



## Command-line arguments



You can customize the launch command of BIND server by specifying arguments to `named` on the `docker run` command. For example the following command prints the help menu of `named` command:



```bash

docker run --name bind -it --rm \

  --publish 53:53/tcp --publish 53:53/udp --publish 10000:10000/tcp \

  --volume /srv/docker/bind:/data \

  sameersbn/bind:9.16.1-20200524 -h

```



## Persistence



For the BIND to preserve its state across container shutdown and startup you should mount a volume at `/data`.



> *The [Quickstart](#quickstart) command already mounts a volume for persistence.*



SELinux users should update the security context of the host mountpoint so that it plays nicely with Docker:



```bash

mkdir -p /srv/docker/bind

chcon -Rt svirt_sandbox_file_t /srv/docker/bind

```



## Reverse Proxying



If you need to run Webmin behind a reverse-proxy such as Nginx, you can tweak the following environment variables:



* `WEBMIN_INIT_SSL_ENABLED`: If Webmin should be served via SSL or not. Defaults to `true`. 

   If you do the SSL termination at an earlier stage, set this to false.



* `WEBMIN_INIT_REDIRECT_PORT`: The port Webmin is served from. 

   Set this to your reverse proxy port, such as `443`. Defaults to `10000`.



* `WEBMIN_INIT_REFERERS`: Sets the allowed referrers to Webmin. 

   Set this to your domain name of the reverse proxy. Example: `mywebmin.example.com`. 

   Defaults to empty (no referrer).



# Maintenance



## Upgrading



To upgrade to newer releases:



  1. Download the updated Docker image:



  ```bash

  docker pull sameersbn/bind:9.16.1-20200524

  ```



  2. Stop the currently running image:



  ```bash

  docker stop bind

  ```



  3. Remove the stopped container



  ```bash

  docker rm -v bind

  ```



  4. Start the updated image



  ```bash

  docker run -name bind -d \

    [OPTIONS] \

    sameersbn/bind:9.16.1-20200524

  ```



## Shell Access



For debugging and maintenance purposes you may want access the containers shell. If you are using Docker version `1.3.0` or higher you can access a running containers shell by starting `bash` using `docker exec`:



```bash

docker exec -it bind bash

```