Dokploy/dokploy · error

Error deploying Compose

Error message

Error deploying Compose

What it means

Inner catch of the compose deploy webhook: preparing/enqueueing the compose deployment threw (queue add failure, invalid deployment config, malformed payload). Responds 400 'Error deploying Compose'; underlying error only in logs.

Source

Thrown at apps/dokploy/pages/api/deploy/compose/[refreshToken].ts:212

			if (IS_CLOUD && composeResult.serverId) {
				jobData.serverId = composeResult.serverId;
				deploy(jobData).catch((error) => {
					console.error("Background deployment failed:", error);
				});
			} else {
				await myQueue.add(
					"deployments",
					{ ...jobData },
					{
						removeOnComplete: true,
						removeOnFail: true,
					},
				);
			}
		} catch (error) {
			logWebhookError("Error deploying Compose:", error);
			res.status(400).json({ message: "Error deploying Compose" });
			return;
		}

		res.status(200).json({ message: "Compose deployed successfully" });
	} catch (error) {
		logWebhookError("Error deploying Compose:", error);
		res.status(400).json({ message: "Error deploying Compose" });
	}
}

View on GitHub (pinned to 546686ea35)

Solutions

1. Read server logs for the logWebhookError entry with the real exception
2. Verify Redis availability (deployments queue)
3. Complete the compose configuration (source, compose type)
4. Send a valid test payload and retry

if (!compose.composeType || !compose.sourceType) throw new Error('Incomplete compose config');

const r = await fetch(composeDeployUrl, ...);
if (!r.ok) { /* read logWebhookError in server logs for root cause */ }

When it happens

Trigger: bullmq add fails (Redis down), compose deployment record creation fails, or the webhook payload lacks expected fields during processing.

Common situations: Redis container stopped/restarted mid-deploy; compose missing required config (e.g. no compose file path); CI sending empty body.

Related errors

• Error deploying Application
• Automatic deployments are disabled for this application
• Automatic deployments are disabled for this compose
• UNAUTHORIZED
• BAD_REQUEST

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