Documentation - Control Panel

Back to Documentation

Overview

The Control Panel is the main screen for Refract DNS and provides access to other parts of the application. Using the Control Panel the user can enable and disable DNS Records and Groups.

  1. Records - list of DNS records managed by Refract DNS.
  2. Groups - list of groups created in Refract DNS.
  3. Statuses - the current state of the Refract DNS service and network interface.
  4. Navigation - provides access to other parts of the application.

Records

The Records list allows you to enable and disabled individual DNS Records with the single click of a button. Buttons to a domain or record will be visible when you hover your mouse over an entry.

  1. Toggles the Enabled Records list.
  2. Opens the Create Record screen (shortcut: CTRL-R).
  3. The Search box allows the user to filter the list of records. Records will be filtered as soon as the user starts to type in the search box. The following content is searchable: domain name, description and IP address of the records. (Shortcut: Hold Ctrl, Press F then R)
  4. List of DNS Records grouped by domain name.

DNS Domain Collection

A DNS Domain Collection is a set of DNS records connected to a single domain. The domain is defined when the user creates a record.

From the DNS Domain Collection the user can turn on and off individual DNS records. When the user turns on a record Refract DNS will check to see if any other matching DNS records are enabled for the domain and then disable them automatically.

For example in the above image the user has three records for the proservers domain. If the user enables Server 3 then Server 1 will be automatically disabled because it is also an A records for this domain. Server 4 will not be disabled because it is an AAAA record for the domain.

The buttons to the right of each DNS record allow the user to edit the current record or delete it.

Right clicking on a domain allows the user to perform the following actions:

  • Copy the domain name.
  • Open the domain in browser. Only available for fully qualified domain names.
  • Copy the punycode domain. Only available if the domain contains non-ASCII characters.

Right clicking on a record allows the user to perform the following actions:

  • Copy IP/Value.

Enabled Records List

The Enabled Records toggle will filter the records list so that only enabled records are visible. It provides a quick method for the user to locate and disable active records.

Groups

Groups allow the user to group DNS records together so that they can be controlled by a single toggle. The user can then enable and disable a collection of DNS records with a single click.

  1. Opens the Create Groups screen (shortcut: CTRL-G).
  2. The Search box allows the user to filter the list of groups. Groups will be filtered as soon as the user starts to type in the search box. The following content is searchable: Group name. (Shortcut: Hold Ctrl, Press F then G)
  3. A Group Record with a collection of DNS records.

Group Record

A Group Record is a set of DNS records that are linked together.

The user can toggle the whole group on or off by using the toggle next to the group name. When the user hovers their mouse over the group buttons to edit and delete the group will appear.

Right clicking on a group allows the user to perform the following actions:

  • Copy the group name.

Right clicking on a group record allows the user to perform the following actions:

  • Copy the domain name.
  • Open the domain in browser. Only available for fully qualified domain names.
  • Copy the punycode domain. Only available if the domain contains non-ASCII characters.
  • Copy the IP/Value.

Statues

This section indicates the current state of the Refract DNS server.

  • Service - this indicates if the Refract DNS Windows Service is currently running. Clicking the toggle will start and stop the Windows Service. If the Window Service is stopped then Refract DNS will not function.
  • Enabled - this indicates if Refract DNS will override DNS requests. This toggle acts as a global enable and disable for all DNS records configured in Refract DNS. When disabled all DNS requests will be passed to the Upstream DNS Server and all Refract DNS records will be ignored (this includes blacklisted domains).
  • Blacklist - this indicates if blacklisted domains will be handled by Refract DNS. This includes blacklisted domains configured in the Refact DNS Manager and in any blacklist files. Disabling blacklisting will allow DNS requests to be proxied to the upstream DNS server.
  • Upstream DNS - The IP of the last upstream DNS server queried by Refract DNS.
  • Network - Indicates if the currently active Network Interface is configured to use Refract DNS. Click on the indicator will take the user to the Settings screen and allow them to configure their Network Interfaces.

These buttons allow the user to navigate to other areas of the application.

  1. Request Log - opens the DNS Request log (shortcut: CTRL-L).
  2. Hosts File Importer - opens the Hosts File Import tool (shortcut: CTRL-I).
  3. Help - opens a browser and takes the user to the documentation on the website (shortcut: CTRL-H).
  4. Settings - opens the settings screen (shortcut: CTRL-O).
  5. About - displays information about the Refract DNS application.

Back to Documentation

About

Remove the frustration of the Windows hosts file and take control of your DNS.

Share
Our Contacts

The Guild Hub, High Street
Bath BA1 5EB