coollabsio/coolify · error · InvalidArgumentException

A valid domain is required for Cloudflare Domain Connect.

Error message

A valid domain is required for Cloudflare Domain Connect.

What it means

Error "A valid domain is required for Cloudflare Domain Connect." thrown in coollabsio/coolify.

Source

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

     */
    public function buildApplyUrl(
        string $domain,
        array $variables = [],
        ?string $host = null,
        ?string $redirectUri = null,
    ): string {
        if (! $this->isAvailable()) {
            throw new RuntimeException(
                'Domain Connect is only available on Coolify Cloud when a Domain Connect private key is configured.'
            );
        }

        $domain = strtolower(trim($domain));
        $domain = preg_replace('#^https?://#', '', $domain) ?? $domain;
        $domain = rtrim(explode('/', $domain)[0] ?? $domain, '.');

        if ($domain === '' || ! str_contains($domain, '.')) {
            throw new InvalidArgumentException('A valid domain is required for Cloudflare Domain Connect.');
        }

        $host = $host === null ? '' : strtolower(trim($host));
        $host = rtrim($host, '.');
        if ($host === '@') {
            $host = '';
        }

        // Signature covers the query string excluding `key` and `sig` (Domain Connect spec).
        $params = [
            'domain' => $domain,
            'host' => $host,
        ];

        foreach ($variables as $name => $value) {
            if ($name === 'domain' || $name === 'host' || $name === 'key' || $name === 'sig') {
                continue;
            }

View on GitHub (pinned to 70b9acc424)

When it happens

Trigger: Thrown at app/Support/DomainConnect/CloudflareDomainConnect.php:67 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/a6622c7296506e80. Report an issue: GitHub.