File README.md of Package bind-container

# ISC Bind9 DNS Server Container

The container provides several labels that are intended to install everything
needed on the host and run the container as a systemd service or manually.
Everything should be run as root since this is meant to install on a system level.
For a rootless container look at other options like the opensuse-bind-image.

## Pulling the container

As root run:
`podman pull registry.opensuse.org/suse/alp/workloads/tumbleweed_containerfiles/suse/alp/workloads/bind:latest`

## Installing

As root run:
`podman container runlabel install registry.opensuse.org/suse/alp/workloads/tumbleweed_containerfiles/suse/alp/workloads/bind:latest`
This installs:
* Default configs into `/etc/` and `/var/lib/named`
* A rndc wrapper into `/usr/local/sbin/`
* Systemd service files for the named server container into `/etc/systemd/system/`

## Running the named server

### As a service

The service(s) can be started manually via:
`systemctl start named.service`
or enabled to start them always at boot
`systemctl enable named.service`

### Manual

The containers can also be started without systemd via (run as root):
`podman container runlabel run registry.opensuse.org/suse/alp/workloads/tumbleweed_containerfiles/suse/alp/workloads/bind:latest`

## Configuring the server

### Config files

The main configuration file is located at `/etc/named.conf`.
A default config is installed and further infos how to configure the server can be found
in the official documentation at https://downloads.isc.org/isc/bind9/cur/9.18/doc/arm/html/chapter3.html

### Using rndc

A wrapper for the official `rndc` tool is also installed that sends the commands to the server inside the container.
The wrapper can be used exactly like the official tool.
If changes are made to the config files mentioned above changes can be applied to the server via `rndc reload`

## Uninstalling

As root run:
`podman container runlabel uninstall registry.opensuse.org/suse/alp/workloads/tumbleweed_containerfiles/suse/alp/workloads/bind:latest`
This uninstalls:
* The configs at `/etc/named.conf`, `/etc/rndc.key` `/etc/named.d/` and `/var/lib/named/`
* The rndc wrapper at `/usr/local/sbin/rndc`
* Systemd service file for the named server container at `/etc/systemd/system/named.service`