coollabsio/coolify · error · RuntimeException

Domain Connect is only available on Coolify Cloud when a Dom

Error message

Domain Connect is only available on Coolify Cloud when a Domain Connect private key is configured.

What it means

Error "Domain Connect is only available on Coolify Cloud when a Domain Connect private key is configured." thrown in coollabsio/coolify.

Source

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

        return (string) config('services.domain_connect.service_id', 'hosting');
    }

    public function keyId(): string
    {
        return (string) config('services.domain_connect.key_id', '_dcpubkeyv1');
    }

    /**
     * @param  array<string, string|null>  $variables  Template variables (e.g. ip). Null values become empty strings.
     */
    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 = '';
        }

View on GitHub (pinned to 70b9acc424)

When it happens

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