https://github.com/tiredofit/docker-unbound
Dockerized recursive and caching DNS resolver
https://github.com/tiredofit/docker-unbound
alpine caching dns docker ns resolver unbound zabbix
Last synced: 11 months ago
JSON representation
Dockerized recursive and caching DNS resolver
- Host: GitHub
- URL: https://github.com/tiredofit/docker-unbound
- Owner: tiredofit
- License: mit
- Created: 2017-09-03T23:08:34.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2025-02-15T03:39:18.000Z (about 1 year ago)
- Last Synced: 2025-03-21T02:21:42.853Z (11 months ago)
- Topics: alpine, caching, dns, docker, ns, resolver, unbound, zabbix
- Language: Dockerfile
- Homepage:
- Size: 79.1 KB
- Stars: 13
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# github.com/tiredofit/docker-unbound
[](https://hub.docker.com/r/tiredofit/unbound)
[](https://hub.docker.com/r/tiredofit/unbound)
## About
Dockerfile to build an [Unbound DNS Cache](https://unbound.net) container image for quicker DNS lookups, mostly useful for mail servers, and other services that repeatedly rely on name resolution.
* This Container uses a [customized Alpine Linux base](https://hub.docker.com/r/tiredofit/alpine) which includes [s6 overlay](https://github.com/just-containers/s6-overlay) enabled for PID 1 Init capabilities, [zabbix-agent](https://zabbix.org) for individual container monitoring, Cron also installed along with other tools (bash,curl, less, logrotate, nano) for easier management. It also supports sending to external SMTP servers..
[Changelog](CHANGELOG.md)
## Maintainer
- [Dave Conroy](https://github.com/tiredofit/)
## Table of Contents
- [About](#about)
- [Maintainer](#maintainer)
- [Table of Contents](#table-of-contents)
- [Prerequisites and Assumptions](#prerequisites-and-assumptions)
- [Installation](#installation)
- [Quick Start](#quick-start)
- [Configuration](#configuration)
- [Persistent Storage](#persistent-storage)
- [Environment Variables](#environment-variables)
- [Networking](#networking)
- [Maintenance](#maintenance)
- [Shell Access](#shell-access)
- [References](#references)
## Prerequisites and Assumptions
None.
## Installation
Automated builds of the image are available on [Docker Hub](https://hub.docker.com/r/tiredofit/unbound)
```bash
docker pull hub.docker.com/tiredofit/unbound:(imagetag)
```
Builds of the image are also available on the [Github Container Registry](https://github.com/tiredofit/docker-tiredofit/pkgs/container/docker-tiredofit)
```
docker pull ghcr.io/tiredofit/docker-tiredofit:(imagetag)
```
The following image tags are available:
* `latest` - Most recent release of Unbound w/ Alpine Linux
### Quick Start
* The quickest way to get started is using [docker-compose](https://docs.docker.com/compose/). See the examples folder for a working [docker-compose.yml](examples/docker-compose.yml) that can be modified for development or production use.
* Set various [environment variables](#environment-variables) to understand the capabilities of this image.
* Map [persistent storage](#data-volumes) for access to configuration and data files for backup.
## Configuration
### Persistent Storage
No files are required for persistent storage.
### Environment Variables
Along with the Environment Variables from the [Base image](https://hub.docker.com/r/tiredofit/alpine), below is the complete list of available options that can be used to customize your installation.
| Parameter | Description | Default |
| --------- | ----------- | ------- |
### Networking
| Port | Description |
| ---- | -------------- |
| `53` | Listening Port |
## Maintenance
### Shell Access
For debugging and maintenance purposes you may want access the containers shell.
```bash
docker exec -it (whatever your container name is e.g. unbound) bash
```
## References
* https://unbound.net