Dokploy/dokploy · error · TRPCError

NOT_FOUND

NOT_FOUND

Error message

Server not found

What it means

Cloud-edition guard in destination testing: in IS_CLOUD mode a serverId must be supplied because rclone runs remotely; missing serverId yields NOT_FOUND 'Server not found'.

Source

Thrown at apps/dokploy/server/api/routers/destination.ts:83

					`--s3-endpoint=${quote([endpoint])}`,
					"--s3-no-check-bucket",
					"--s3-force-path-style",
					"--retries 1",
					"--low-level-retries 1",
					"--timeout 10s",
					"--contimeout 5s",
				];
				if (provider) {
					rcloneFlags.unshift(`--s3-provider=${quote([provider])}`);
				}
				if (additionalFlags?.length) {
					rcloneFlags.push(...additionalFlags);
				}
				const rcloneDestination = `:s3:${bucket}`;
				const rcloneCommand = `rclone ls ${rcloneFlags.join(" ")} ${quote([rcloneDestination])}`;

				if (IS_CLOUD && !input.serverId) {
					throw new TRPCError({
						code: "NOT_FOUND",
						message: "Server not found",
					});
				}

				if (IS_CLOUD) {
					await execAsyncRemote(input.serverId || "", rcloneCommand);
				} else {
					await execAsync(rcloneCommand);
				}
			} catch (error) {
				throw new TRPCError({
					code: "BAD_REQUEST",
					message:
						error instanceof Error
							? error?.message
							: "Error connecting to bucket",
					cause: error,

View on GitHub (pinned to 546686ea35)

Solutions

1. Pass a valid serverId when using Dokploy Cloud
2. Select a server in the UI before testing the destination
3. Guard client-side: if cloud, require serverId

Example fix

// before
await api.destination.test({ bucket, accessKey, secretKey });
// after
await api.destination.test({ bucket, accessKey, secretKey, serverId: requiredServerId });

if (isCloud && !serverId) throw new Error('serverId required on cloud');

When it happens

Trigger: Calling the destination test/connect mutation on Dokploy Cloud without a serverId, or with a serverId that is empty.

Common situations: Client code written for self-hosted (where serverId is optional) run against the cloud edition; UI not passing the selected server.

Understand the failure class

Background: Missing required parameter errors: what 'X is required' and 'the required X param is missing' mean, and how to fix them — this error's family across 27 libraries.

Related errors

• UNAUTHORIZED
• UNAUTHORIZED
• UNAUTHORIZED
• UNAUTHORIZED
• BAD_REQUEST

AI-assisted analysis of Dokploy/dokploy@546686ea35 (2026-08-27). Data as JSON: /api/errors/e8e4547df4e15b82. Report an issue: GitHub.