KyDNS

DNS for your home network with easy service names and ad blocking.

  • ghcr.io/busnes-app/kydns-server:0.6.0.1
  • v0.6.0.1
  • Updated 9 Nov 2026
  • port 6697
  • port 53
  • port 53
  • amd64 · arm64
  • Networking
  • 1 stars

Screenshots

KyDNS screenshot 1: DashboardKyDNS screenshot 2: Settings

Open the app

Admin

http://localhost:6697/

First-run setup

http://localhost:6697/setup

About KyDNS

KyDNS is a DNS server and service directory for homes, homelabs and small teams. Give your services names like nas.home.arpa once, and every device on your network can reach them. It also blocks ads and trackers with built-in and your own block lists. Part of the Busnes Ky Suite; it works on its own.

Features

  • Private service names, DNS records and per-network views
  • Ad and tracker blocking with block lists, allow and deny rules
  • Encrypted upstream DNS
  • Query log and statistics
  • Optional replication between two KyDNS servers, backups to KyRecovery and an MCP server for AI agents

How to use

  1. Copy the setup token from the app's logs.
  2. Open http://[ZIMAOS-IP-ADDRESS]:6697/setup, enter the token and choose your admin password.
  3. Add your services and names.
  4. Point a test device's DNS at your ZimaOS IP. When it works, set it in your router for every device.

Before you install

KyDNS answers DNS on port 53 of your ZimaOS box (UDP and TCP), so nothing else there may use it: stop AdGuard Home, Pi-hole or any other DNS app first. The admin page is on port 6697.

On the first start KyDNS prints a setup token in its logs and also writes it to setup-token in /DATA/AppData/kydns/data. Open http://[ZIMAOS-IP-ADDRESS]:6697/setup, enter it and choose a password. Test with one device before you change your router's DNS. Most settings (upstream resolvers, block lists, names) are changed on the admin page; the few others are in the Variables tab and are added in the app settings. The built-in DHCP server needs host networking, so it is not available here.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone. Leave it unless you need another.

Admin page

VariableDefault valueDescription
KYDNS_ADMIN_HOSTNAMES—Extra names you open the admin page by, like kydns.home.arpa. It always answers on localhost and IP addresses.
KYDNS_TRUSTED_PROXIES—The address of a reverse proxy in front of the admin page, so KyDNS believes the visitor's IP from it. It does not limit who can connect.

Backups

VariableDefault valueDescription
KYDNS_BACKUP_DEPOSIT_INTERVAL24hHow often KyDNS sends a sealed backup to a paired KyRecovery.
KYDNS_BACKUP_DIR—A folder inside the container for local backups, like /var/lib/kydns/backups.
KYDNS_BACKUP_KEEP7How many local backups to keep.
KYDNS_BACKUP_ALLOW_PRIVATE_RECOVERYfalseSet to true for a KyRecovery on your home network (it still needs https).
docker-compose.yml
name: kydns

services:
  kydns:
    image: ghcr.io/busnes-app/kydns-server:0.6.0.1
    container_name: kydns
    restart: unless-stopped
    stop_grace_period: 20s
    network_mode: bridge
    user: "0:0"
    environment:
      - TZ=$TZ
    ports:
      - target: 8053
        published: "6697"
        protocol: tcp
      - target: 53
        published: "53"
        protocol: udp
      - target: 53
        published: "53"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /var/lib/kydns
        bind:
          create_host_path: true
    deploy:
      resources:
        limits:
          cpus: "1.00"
          memory: 256M
        reservations:
          cpus: "0.00"
          memory: 32M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/kydns/icon.png
    x-casaos:
      id: com.icestore.kydns
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
              Leave it unless you need another.
      ports:
        - container: "8053"
          description:
            en_US: KyDNS admin web page and API, published on host as 6697
        - container: "53"
          description:
            en_US: >-
              DNS, published on host as 53 (UDP and TCP). Devices that use
              your ZimaOS as their DNS server ask here. Nothing else on the
              box may use port 53.
      volumes:
        - container: /var/lib/kydns
          description:
            en_US: >-
              The database (kydns.db) with your names, records and settings,
              and the setup-token and bootstrap-token files. Back it up.

x-casaos:
  id: com.icestore.kydns
  architectures:
    - amd64
    - arm64
  main: kydns
  author: HSinghHira
  category: Networking
  developer: Busnes-app
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/kydns/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/kydns/screenshot-1.jpg
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/kydns/screenshot-1.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/kydns/screenshot-2.jpg
  title:
    en_US: KyDNS
  tagline:
    en_US: DNS for your home network with easy service names and ad blocking.
  description:
    en_US: >-
      Visit: [https://icestore.hsinghhira.me/app/kydns/](https://icestore.hsinghhira.me/app/kydns/) for full details


      KyDNS is a DNS server and service directory for homes, homelabs and
      small teams. Give your services names like nas.home.arpa once, and
      every device on your network can reach them. It also blocks ads and
      trackers with built-in and your own block lists. Part of the Busnes Ky
      Suite; it works on its own.


      **Features**


      - Private service names, DNS records and per-network views

      - Ad and tracker blocking with block lists, allow and deny rules

      - Encrypted upstream DNS

      - Query log and statistics

      - Optional replication between two KyDNS servers, backups to
        KyRecovery and an MCP server for AI agents


      **How to use?**


      1. Copy the setup token from the app's logs.


      2. Open http://[ZIMAOS-IP-ADDRESS]:6697/setup, enter the token and
         choose your admin password.


      3. Add your services and names.


      4. Point a test device's DNS at your ZimaOS IP. When it works, set it
         in your router for every device.
  tips:
    before_install:
      en_US: >-
        1. KyDNS needs port 53 on your ZimaOS box. Stop any other DNS app
           first (like AdGuard Home or Pi-hole), or the install fails.


        2. Start the installation. It is ready in a few seconds.


        3. Open the app's logs and copy the setup token (the line with
           setup-token). It is also in the setup-token file in the data
           folder (AppData, kydns, data).


        4. Open http://[ZIMAOS-IP-ADDRESS]:6697/setup, paste the token and
           choose your admin password.


        5. Test it from one device first: set that device's DNS server to
           your ZimaOS IP. When names work, set it in your router.


        6. More settings (backups, your proxy, extra admin names) are listed
           on the KyDNS page at https://icestore.hsinghhira.me/app/kydns/
           (Variables tab). You can add them now or later in the app
           settings.
  index: /
  port_map: "6697"
  scheme: http
  is_uncontrolled: false
  version: "0.6.0.1"
  update_at: "2026-11-09"
  release_notes:
    en_US: |-
      - First IceStore version: ghcr.io/busnes-app/kydns-server 0.6.0.1
      - Admin page on port 6697 and DNS on port 53 (UDP and TCP); the data folder is /DATA/AppData/kydns/data. Runs as root so it can use port 53 and write to that folder.
      - Uses the image's built-in config (data in /var/lib/kydns, admin on 0.0.0.0:8053). DHCP is not available in this setup.
  repo: "https://github.com/Busnes-app/KyDNS-server"
  support: "https://github.com/Busnes-app/KyDNS-server/issues"
  docs: "https://github.com/Busnes-app/KyDNS-server/blob/main/INSTALL.md"

Install KyDNS

Something not working with KyDNS?

Report it so it gets fixed, or ask for an app that is not here yet.

More Networking apps

See all