sqlmapproject/sqlmap · error · SqlmapGenericException

there was an error while setting up the interactsh DNS colle

Error message

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

What it means

Error "there was an error while setting up the interactsh DNS collector ('%s')" thrown in sqlmapproject/sqlmap.

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)

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.