{"id":15199853,"url":"https://github.com/sameersbn/docker-bind","last_synced_at":"2025-05-16T04:06:15.443Z","repository":{"id":15225436,"uuid":"17954072","full_name":"sameersbn/docker-bind","owner":"sameersbn","description":"Dockerize BIND DNS server with webmin for DNS administration","archived":false,"fork":false,"pushed_at":"2024-04-01T16:16:23.000Z","size":115,"stargazers_count":926,"open_issues_count":27,"forks_count":331,"subscribers_count":45,"default_branch":"master","last_synced_at":"2025-05-15T12:58:45.977Z","etag":null,"topics":["bind","containers","dns","docker","docker-image"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sameersbn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-03-20T18:39:34.000Z","updated_at":"2025-04-17T09:52:31.000Z","dependencies_parsed_at":"2024-09-19T01:04:15.394Z","dependency_job_id":null,"html_url":"https://github.com/sameersbn/docker-bind","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameersbn%2Fdocker-bind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameersbn%2Fdocker-bind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameersbn%2Fdocker-bind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameersbn%2Fdocker-bind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sameersbn","download_url":"https://codeload.github.com/sameersbn/docker-bind/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254464895,"owners_count":22075570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bind","containers","dns","docker","docker-image"],"created_at":"2024-09-28T02:05:11.729Z","updated_at":"2025-05-16T04:06:15.394Z","avatar_url":"https://github.com/sameersbn.png","language":"Shell","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)\n\n# sameersbn/bind:9.16.1-20200524\n\n- [Introduction](#introduction)\n  - [Contributing](#contributing)\n  - [Issues](#issues)\n- [Getting started](#getting-started)\n  - [Installation](#installation)\n  - [Quickstart](#quickstart)\n  - [Command-line arguments](#command-line-arguments)\n  - [Persistence](#persistence)\n- [Maintenance](#maintenance)\n  - [Upgrading](#upgrading)\n  - [Shell Access](#shell-access)\n\n# Introduction\n\n`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.\n\nBIND 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.\n\n## Contributing\n\nIf you find this image useful here's how you can help:\n\n- Send a pull request with your awesome features and bug fixes\n- Help users resolve their [issues](../../issues?q=is%3Aopen+is%3Aissue).\n- Support the development of this image with a [donation](http://www.damagehead.com/donate/)\n\n## Issues\n\nBefore 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.\n\nSELinux users should try disabling SELinux using the command `setenforce 0` to see if it resolves the issue.\n\nIf the above recommendations do not help then [report your issue](../../issues/new) along with the following information:\n\n- Output of the `docker version` and `docker info` commands\n- The `docker run` command or `docker-compose.yml` used to start the image. Mask out the sensitive bits.\n- Please state if you are using [Boot2Docker](http://www.boot2docker.io), [VirtualBox](https://www.virtualbox.org), etc.\n\n# Getting started\n\n## Installation\n\nAutomated builds of the image are available on [Dockerhub](https://hub.docker.com/r/sameersbn/bind) and is the recommended method of installation.\n\n\u003e **Note**: Builds are also available on [Quay.io](https://quay.io/repository/sameersbn/bind)\n\n```bash\ndocker pull sameersbn/bind:9.16.1-20200524\n```\n\nAlternatively you can build the image yourself.\n\n```bash\ndocker build -t sameersbn/bind github.com/sameersbn/docker-bind\n```\n\n## Quickstart\n\nStart BIND using:\n\n```bash\ndocker run --name bind -d --restart=always \\\n  --publish 53:53/tcp --publish 53:53/udp --publish 10000:10000/tcp \\\n  --volume /srv/docker/bind:/data \\\n  sameersbn/bind:9.16.1-20200524\n```\n\n*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/)*\n\nWhen 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.\n\nThe 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.\n\nRead 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.\n\n## Command-line arguments\n\nYou 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:\n\n```bash\ndocker run --name bind -it --rm \\\n  --publish 53:53/tcp --publish 53:53/udp --publish 10000:10000/tcp \\\n  --volume /srv/docker/bind:/data \\\n  sameersbn/bind:9.16.1-20200524 -h\n```\n\n## Persistence\n\nFor the BIND to preserve its state across container shutdown and startup you should mount a volume at `/data`.\n\n\u003e *The [Quickstart](#quickstart) command already mounts a volume for persistence.*\n\nSELinux users should update the security context of the host mountpoint so that it plays nicely with Docker:\n\n```bash\nmkdir -p /srv/docker/bind\nchcon -Rt svirt_sandbox_file_t /srv/docker/bind\n```\n\n## Reverse Proxying\n\nIf you need to run Webmin behind a reverse-proxy such as Nginx, you can tweak the following environment variables:\n\n* `WEBMIN_INIT_SSL_ENABLED`: If Webmin should be served via SSL or not. Defaults to `true`. \n   If you do the SSL termination at an earlier stage, set this to false.\n\n* `WEBMIN_INIT_REDIRECT_PORT`: The port Webmin is served from. \n   Set this to your reverse proxy port, such as `443`. Defaults to `10000`.\n\n* `WEBMIN_INIT_REFERERS`: Sets the allowed referrers to Webmin. \n   Set this to your domain name of the reverse proxy. Example: `mywebmin.example.com`. \n   Defaults to empty (no referrer).\n\n# Maintenance\n\n## Upgrading\n\nTo upgrade to newer releases:\n\n  1. Download the updated Docker image:\n\n  ```bash\n  docker pull sameersbn/bind:9.16.1-20200524\n  ```\n\n  2. Stop the currently running image:\n\n  ```bash\n  docker stop bind\n  ```\n\n  3. Remove the stopped container\n\n  ```bash\n  docker rm -v bind\n  ```\n\n  4. Start the updated image\n\n  ```bash\n  docker run -name bind -d \\\n    [OPTIONS] \\\n    sameersbn/bind:9.16.1-20200524\n  ```\n\n## Shell Access\n\nFor 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`:\n\n```bash\ndocker exec -it bind bash\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsameersbn%2Fdocker-bind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsameersbn%2Fdocker-bind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsameersbn%2Fdocker-bind/lists"}