appwrite/appwrite · error · Exception

Failed to connect installer to appwrite network: {$outputStr

Error message

Failed to connect installer to appwrite network: {$outputStr}

What it means

Error "Failed to connect installer to appwrite network: {$outputStr}" thrown in appwrite/appwrite.

Source

Thrown at src/Appwrite/Platform/Tasks/Install.php:1033

        $outputStr = '';
        for ($i = 0; $i < 10; $i++) {
            $output = [];
            @exec("docker network connect {$network} {$container} 2>&1", $output, $exitCode);

            if ($exitCode === 0) {
                return;
            }

            $outputStr = implode(' ', $output);
            if (str_contains($outputStr, 'already exists')) {
                return;
            }

            sleep(1);
        }

        throw new \Exception('Failed to connect installer to appwrite network: ' . $outputStr);
    }

    private function makeApiCall(string $endpoint, array $body, bool $extractSession = false, string $apiUrl = self::APPWRITE_API_URL, string $domain = 'localhost')
    {
        $client = new Client();
        $client
            ->setTimeout(30000)
            ->setConnectTimeout(10000)
            ->addHeader('Content-Type', 'application/json')
            ->addHeader('X-Appwrite-Project', 'console')
            ->addHeader('Host', $domain);

        $url = $apiUrl . $endpoint;
        $response = $client->fetch($url, Client::METHOD_POST, $body);

        if ($response->getStatusCode() !== 201) {
            $error = $response->json();
            $message = $error['message'] ?? ('HTTP ' . $response->getStatusCode() . ': ' . $response->getBody());

View on GitHub (pinned to a1d520eea4)

Solutions

1. Ensure the 'appwrite' Docker network exists (docker network ls); create it with 'docker network create appwrite' if missing, then retry.
2. Run the installer with the same Docker context/host that runs the Appwrite stack so the network is visible.

When it happens

Trigger: Thrown at src/Appwrite/Platform/Tasks/Install.php:1033 when the library encounters an invalid state.

Common situations: See trigger scenarios.

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