{"id":19434145,"url":"https://github.com/mastermindg/rpi-dns","last_synced_at":"2025-04-24T20:31:58.416Z","repository":{"id":76585316,"uuid":"50271825","full_name":"mastermindg/rpi-dns","owner":"mastermindg","description":"Bind on Docker on Pi","archived":false,"fork":false,"pushed_at":"2016-01-24T04:20:58.000Z","size":5,"stargazers_count":14,"open_issues_count":0,"forks_count":11,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-03T10:37:20.541Z","etag":null,"topics":[],"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/mastermindg.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}},"created_at":"2016-01-24T04:18:56.000Z","updated_at":"2024-05-01T15:59:30.000Z","dependencies_parsed_at":"2023-04-19T14:25:16.678Z","dependency_job_id":null,"html_url":"https://github.com/mastermindg/rpi-dns","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mastermindg%2Frpi-dns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mastermindg%2Frpi-dns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mastermindg%2Frpi-dns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mastermindg%2Frpi-dns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mastermindg","download_url":"https://codeload.github.com/mastermindg/rpi-dns/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250704769,"owners_count":21473758,"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":[],"created_at":"2024-11-10T14:44:50.565Z","updated_at":"2025-04-24T20:31:58.194Z","avatar_url":"https://github.com/mastermindg.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"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# mastermindg/rpi-dns:latest\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\nForked from sameersbn/bind - DNS for Raspberry Pi's over Docker\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:latest\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/udp --publish 10000:10000 \\\n  --volume /srv/docker/bind:/data \\\n  sameersbn/bind:latest\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 http://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/udp --publish 10000:10000 \\\n  --volume /srv/docker/bind:/data \\\n  sameersbn/bind:latest -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# 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:latest\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:latest\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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmastermindg%2Frpi-dns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmastermindg%2Frpi-dns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmastermindg%2Frpi-dns/lists"}