sqlmapproject/sqlmap · error · SqlmapGenericException

there was an error while setting up the interactsh DNS…

Error message

there was an error while setting up the interactsh DNS collector ('%s')

What it means

Thrown by _setDNSServer when InteractshDNSServer.run() (interactsh-backed out-of-band DNS collector requested via --dns-domain=interactsh/oast/oob or a known interactsh server) raises during setup/registration — typically network failure reaching the interactsh server or client registration error.

Solutions

1. Check network connectivity to the interactsh/OAST server
2. Verify no proxy/firewall blocks the outbound connection
3. Retry later or use a self-hosted interactsh server
4. Remove the --dns-domain option if OOB collection is not required

When it happens

Trigger: Thrown at lib/core/option.py:2651 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of sqlmapproject/sqlmap@0a35b20e39 (2026-08-26). Data as JSON: /api/errors/d27a0d9afca30684. Report an issue: GitHub.

Appendix: source

Thrown at lib/core/option.py:2651

def _setDNSServer():
    if not conf.dnsDomain:
        return

    from lib.core.settings import OOB_INTERACTSH_SERVERS

    _requested = conf.dnsDomain.strip().lower()
    if _requested in ("interactsh", "oast", "oob") or _requested in OOB_INTERACTSH_SERVERS:
        infoMsg = "setting up interactsh-backed DNS exfiltration collector"
        logger.info(infoMsg)

        try:
            conf.dnsServer = InteractshDNSServer(server=_requested if _requested in OOB_INTERACTSH_SERVERS else None)
            conf.dnsServer.run()
            conf.dnsDomain = conf.dnsServer.domain
        except socket.error as ex:
            errMsg = "there was an error while setting up "
            errMsg += "the interactsh DNS collector ('%s')" % getSafeExString(ex)
            raise SqlmapGenericException(errMsg)

        infoMsg = "using interactsh DNS collector (exfiltration domain '%s')" % conf.dnsDomain
        logger.info(infoMsg)
        return

    infoMsg = "setting up DNS server instance"
    logger.info(infoMsg)

    isAdmin = runningAsAdmin()

    if isAdmin:
        try:
            conf.dnsServer = DNSServer()
            conf.dnsServer.run()
        except socket.error as ex:
            errMsg = "there was an error while setting up "
            errMsg += "DNS server instance ('%s')" % getSafeExString(ex)
            raise SqlmapGenericException(errMsg)

View on GitHub (pinned to 0a35b20e39)