coollabsio/coolify · error · InvalidArgumentException

A valid IPv4 or IPv6 address is required for DNS autoconfigu

Error message

A valid IPv4 or IPv6 address is required for DNS autoconfigure.

What it means

Error "A valid IPv4 or IPv6 address is required for DNS autoconfigure." thrown in coollabsio/coolify.

Source

Thrown at app/Support/DomainConnect/CloudflareDomainConnect.php:117

            .'&sig='.rawurlencode($signature);

        return self::CLOUDFLARE_SYNC_UX
            .'/v2/domainTemplates/providers/'.rawurlencode($this->providerId())
            .'/services/'.rawurlencode($this->serviceId())
            .'/apply?'.$finalQuery;
    }

    /**
     * Point a zone (and optional host) A record at the Coolify server IP.
     */
    public function buildHostingApplyUrl(
        string $domain,
        string $ip,
        ?string $host = null,
        ?string $redirectUri = null,
    ): string {
        if (filter_var($ip, FILTER_VALIDATE_IP) === false) {
            throw new InvalidArgumentException('A valid IPv4 or IPv6 address is required for DNS autoconfigure.');
        }

        return $this->buildApplyUrl(
            domain: $domain,
            variables: ['ip' => $ip],
            host: $host,
            redirectUri: $redirectUri,
        );
    }

    /**
     * Split a hostname into its registrable domain and relative host.
     *
     * Uses a small multi-part public-suffix set for common cases (e.g. co.uk)
     * instead of shipping the full Mozilla Public Suffix List (~300KB).
     * Unknown multi-part TLDs fall back to last-two-labels; Cloudflare will
     * still match the user's zone when the guess is close enough.
     *

View on GitHub (pinned to 70b9acc424)

When it happens

Trigger: Thrown at app/Support/DomainConnect/CloudflareDomainConnect.php:117 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of coollabsio/coolify@70b9acc424 (2026-08-17). Data as JSON: /api/errors/02e07be1fb795153. Report an issue: GitHub.