Skip to content

Latest commit

 

History

History
69 lines (58 loc) · 2.99 KB

README.md

File metadata and controls

69 lines (58 loc) · 2.99 KB
Raw

docker_pdns

Configuration files and docker compose file for installation of Power DNS, with NSedit as frontend and MariaDB as backend

Requirements:

  • Ubuntu 16.04 / Debian
  • Docker
  • Docker Compose
  • Sudo access

This setup installs following services:

  1. PowerDNS authoritative server: Version 4.1.4
  2. MariaDB backend for PowerDNS: Version 10.2

File Descriptions:

  1. docker-compose.yml: Contains service definitions of all docker containers
  2. pdns.conf: Configuration file for PowerDNS server
  3. pdns_schema.sql: SQL schema for PowerDNS required at installation
  4. example_config: Example configuration files from a single host setup (All service on one host)

These services can be installed on a single host but it is recommended to install them on separate hosts

Steps to Setup PowerDNS with MariaDB backend and NSedit as frontend:

  1. Install Docker:

    sudo curl -sSL https://get.docker.io | bash

  2. Install Docker Compose: https://docs.docker.com/compose/install/#install-compose

    sudo curl -L https://github.com/docker/compose/releases/download/1.18.0/docker-compose-`uname -s-uname -m` -o /usr/local/bin/docker-compose

    sudo chmod +x /usr/local/bin/docker-compose

    docker-compose --version

  3. Clone the repository:

    git clone https://github.com/sahilkalra1991/docker_pdns.git

    cd docker_pdns

  4. Configure and Install MariaDB: https://hub.docker.com/_/mariadb/

    • Configure via Environemnt variables in docker-compose.yml:
      • MYSQL_ROOT_PASSWORD: root user password for Mariadb
      • MYSQL_DATABASE: Empty database to be created
      • MYSQL_USER: New User to create with MYSQL_DATABASE access
      • MYSQL_PASSWORD: New User's password
      • Other variables: https://hub.docker.com/_/mariadb/
    • Create data volume:

      docker volume create --name=mariadb-data

    • Start service:

      docker-compose up -d mariadb

  5. Configure and Install PowerDNS: https://hub.docker.com/r/psitrax/powerdns/

    • Configure via Configuration file pdns.conf
      • pdns.conf will be overwritten to /etc/pdns/pdns.conf inside the container.
      • Required: Provide All settings marked with <TODO> i.e. search for TODO in pdns.conf and provide required values e.g. api_key, allow-axfr-ips, allow-notify-from, gmysql-host etc
      • Optional: Other settings in the file. Change as per requirement
    • Create PowerDNS schema via pdns_schema.sql:

      mysql -h <host_ip> -u pdns -p pdns < pdns_schema.sql

    • Start service:

      docker-compose up -d pdns-server

Check Logs for respective services:

  • Use command: docker-compose logs -f <service_name> e.g.

    docker-compose logs -f pdns-server

Other docker-compose commands:

  • Check status of services:

    docker-compose ps

  • Stop service(s)

    docker-compose stop [service_name]

  • Remove container(s)

    docker-compose rm [service_name]

  • Logs for a service

    docker-compose logs [-f] service_name