{"record":{"id":"e577d246f3ed3d0f","repo":"coollabsio/coolify","slug":"instance-url-fqdn-or-app-url-must-be-set-before","errorCode":null,"errorMessage":"Instance URL (FQDN or APP_URL) must be set before claiming a server.","messagePattern":"Instance URL \\(FQDN or APP_URL\\) must be set before claiming a server\\.","errorType":"exception","errorClass":"RuntimeException","httpStatus":null,"severity":"error","filePath":"app/Services/ServerTransfer/ServerTransferClaimer.php","lineNumber":36,"sourceCode":"     * best-effort — they cannot participate in the DB transaction.\n     *\n     * @return array{\n     *     server_uuid: string,\n     *     claim: array<string, mixed>,\n     *     sentinel_rebound: bool,\n     *     claim_written: bool,\n     *     message: string\n     * }\n     */\n    public function claim(Server $server, bool $writeRemote = true, bool $rebindSentinel = true): array\n    {\n        if ($server->id === 0) {\n            throw new RuntimeException('Cannot claim the Coolify host itself.');\n        }\n\n        $instanceUrl = rtrim((string) (instanceSettings()->fqdn ?: config('app.url')), '/');\n        if ($instanceUrl === '') {\n            throw new RuntimeException('Instance URL (FQDN or APP_URL) must be set before claiming a server.');\n        }\n\n        $exportId = data_get($server->server_metadata, 'transfer.export_id');\n\n        $claim = [\n            'instance_url' => $instanceUrl,\n            'server_uuid' => $server->uuid,\n            'team_id' => $server->team_id,\n            'claimed_at' => now()->toIso8601String(),\n            'export_id' => $exportId,\n            'schema_version' => ServerTransferBundle::SCHEMA_VERSION,\n        ];\n\n        $result = DB::transaction(function () use ($server, $claim, $rebindSentinel, $instanceUrl) {\n            $server = Server::query()->with('settings')->lockForUpdate()->findOrFail($server->id);\n\n            $sentinelRebound = false;\n            if ($rebindSentinel && $server->settings) {","sourceCodeStart":18,"sourceCodeEnd":54,"githubUrl":"https://github.com/coollabsio/coolify/blob/70b9acc42467278373e00de77abb40684e25b395/app/Services/ServerTransfer/ServerTransferClaimer.php#L18-L54","documentation":"Error \"Instance URL (FQDN or APP_URL) must be set before claiming a server.\" thrown in coollabsio/coolify.","triggerScenarios":"Thrown at app/Services/ServerTransfer/ServerTransferClaimer.php:36 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":[],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"70b9acc42467278373e00de77abb40684e25b395","analyzedAt":"2026-08-17T01:41:01.313Z","schemaVersion":2},"datasetVersion":"2026-08-17T04:17:16.089Z"}