coollabsio/coolify · error · RuntimeException

The Coolify host (localhost) cannot be transferred between i

Error message

The Coolify host (localhost) cannot be transferred between instances.

What it means

Error "The Coolify host (localhost) cannot be transferred between instances." thrown in coollabsio/coolify.

Source

Thrown at app/Services/ServerTransfer/ServerTransferMigrator.php:41

     *     export_id: string|null,
     *     target_url: string,
     *     import: array<string, mixed>,
     *     complete: array<string, mixed>,
     *     warnings: list<string>,
     *     message: string
     * }
     */
    public function migrate(
        Server $server,
        string $targetUrl,
        string $targetToken,
        bool $writeRemote = false,
        bool $rebindSentinel = true,
        bool $preserveUuids = true,
        bool $adoptMode = true,
    ): array {
        if ($server->id === 0) {
            throw new RuntimeException('The Coolify host (localhost) cannot be transferred between instances.');
        }

        $targetUrl = $this->normalizeTargetUrl($targetUrl);
        $token = $this->normalizeToken($targetToken);

        $bundle = $this->exporter->export($server, includeSensitive: true);
        $exportId = data_get($bundle, 'export_id');
        $warnings = array_values((array) data_get($bundle, 'warnings', []));

        // Target import+claim runs in its own DB transaction on the remote instance.
        // Source DB is unchanged until markTransferred below — so a failed remote import leaves source intact.
        $importBody = $this->postImportToTarget(
            targetUrl: $targetUrl,
            token: $token,
            bundle: $bundle,
            writeRemote: $writeRemote,
            rebindSentinel: $rebindSentinel,
            preserveUuids: $preserveUuids,

View on GitHub (pinned to 70b9acc424)

When it happens

Trigger: Thrown at app/Services/ServerTransfer/ServerTransferMigrator.php:41 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/ce8eaa309c7a5605. Report an issue: GitHub.