SlimDNS - ArchWiki

Jump to content

# SlimDNS

From ArchWiki

Related articles

- PowerDNS
- PostgreSQL

This article or section needs language, wiki syntax or style improvements. See Help:Style for reference.

Reason: Many Help:Style issues (Discuss in Talk:SlimDNS)

slimDNS is a simple DNS server. Its purpose is to be a self-contained, slim and uncomplicated executable.

It relies on PostgreSQL for its zone and record information.

## Installation

Install slimDNS-gitAUR or clone github.com/Torxed/slimDNS and follow the manual setup instructions.

## Manual setup (optional)

Create a user/role called "slimdns"

    [postgres@machine~] createuser --interactive
    [postgres@machine~] psql
    > CREATE DATABASE slimdns OWNER slimdns;
    > ALTER USER slimdns WITH PASSWORD '<some secure random string>';

## Running

start and enable `slimDNS.service`.

Or if preferred, running it manually:

    # python slimdns.py

## Configuration

Configuration is stored under `/etc/slimDNS/config.py`, any changes to it requires a restart.

SlimDNS comes with a tool to modify the database, it is called `dnstool` (subject to name change). The tool takes a series of parameters in order and can create domains (zones) and records.

Note: Creating a domain, will not set up SOA or NS records by default. However, creating a record will automatically set up a SOA and NS record if the specified domain is not found.

### Adding a domain (optional)

    # python dnstool.py example.com

### Adding a A record

    # python dnstool.py example.com 46.21.102.81

Note: Again, if the domain `example.com` did not exist, a domain entry would be inserted and appropriate SOA and NS records will be inserted as well for this new domain.

You can also add the same record, but define the record type:

    # python dnstool.py example.com 46.21.102.81 A

### Adding a MX record/complex records

Some records have more complex structure, for instance the SRV, MX or TXT records. In order to be generic in handling these records, enclose the content of the record and add all the necessary data needed for the desired record type.

    # python dnstool.py example.com "46.21.102.81 10" MX

This would create a MX record, with a priority or preference of 10.

## Handy information

- Updates run time cache every 30 seconds.
- Does support a forwarding DNS server, however, testing on this is limited
- Upon each start, slimdns will attempt to create the database 'slimdns' if not found, but will need this optional permissions to work.
- Might crash for no aparent reason :D

Category:

- Domain Name System

Hidden category:

- Pages or sections flagged with Template:Style