appwrite/appwrite · error · Appwrite\Extend\Exception

AVATAR_REMOTE_URL_FAILED

AVATAR_REMOTE_URL_FAILED

Error message

Failed to fetch favicon from the requested URL.

What it means

Error "Failed to fetch favicon from the requested URL." thrown in appwrite/appwrite.

Source

Thrown at src/Appwrite/Platform/Modules/Avatars/Http/Favicon/Get.php:91

        $width = 56;
        $height = 56;
        $quality = 80;
        $output = 'png';

        if (!\extension_loaded('imagick')) {
            throw new Exception(Exception::GENERAL_SERVER_ERROR, 'Imagick extension is missing');
        }

        $userAgent = \sprintf(
            APP_USERAGENT,
            System::getEnv('_APP_VERSION', 'UNKNOWN'),
            System::getEnv('_APP_EMAIL_SECURITY', System::getEnv('_APP_SYSTEM_SECURITY_EMAIL_ADDRESS', APP_EMAIL_SECURITY))
        );

        try {
            $pageResponse = $this->safeFetch($url, $userAgent);
        } catch (\Throwable) {
            throw new Exception(Exception::AVATAR_REMOTE_URL_FAILED);
        }

        $body = $pageResponse->getBody();

        $doc = new DOMDocument();
        $doc->strictErrorChecking = false;
        if (!empty($body)) {
            @$doc->loadHTML($body);
        }

        $links = $doc->getElementsByTagName('link');
        $outputHref = '';
        $outputExt = '';
        $space = 0;

        foreach ($links as $link) { /* @var $link DOMElement */
            $href = $link->getAttribute('href');
            $rel = $link->getAttribute('rel');

View on GitHub (pinned to a1d520eea4)

Solutions

1. Verify the target URL is reachable from the server and returns a successful response.
2. Check DNS resolution and outbound network access from the Appwrite container.

When it happens

Trigger: Thrown by the favicon endpoint when fetching the remote page or favicon from the requested URL fails (network error, DNS failure, non-2xx response).

Common situations: Occurs when the favicon endpoint cannot retrieve the remote page to locate its favicon.

AI-assisted analysis of appwrite/appwrite@a1d520eea4 (2026-08-18). Data as JSON: /api/errors/53ff7f56e3cd1379. Report an issue: GitHub.