Dokploy/dokploy · warning

Automatic deployments are disabled for this compose

Error message

Automatic deployments are disabled for this compose

What it means

The compose was found by refresh token but autoDeploy is false, so the compose deploy webhook responds 400 'Automatic deployments are disabled for this compose'.

Source

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

		}
		const composeResult = await db.query.compose.findFirst({
			where: eq(compose.refreshToken, refreshToken as string),
			with: {
				environment: {
					with: {
						project: true,
					},
				},
				bitbucket: true,
			},
		});

		if (!composeResult) {
			res.status(404).json({ message: "Compose Not Found" });
			return;
		}
		if (!composeResult?.autoDeploy) {
			res.status(400).json({
				message: "Automatic deployments are disabled for this compose",
			});
			return;
		}

		const deploymentTitle = extractCommitMessage(req.headers, req.body);
		const deploymentHash = extractHash(req.headers, req.body);
		const sourceType = composeResult.sourceType;

		if (sourceType === "github") {
			const branchName = extractBranchName(req.headers, req.body);
			const normalizedCommits = req.body?.commits?.flatMap((commit: any) => [
				...(commit.added || []),
				...(commit.modified || []),
				...(commit.removed || []),
			]);

			const shouldDeployPaths = shouldDeploy(

View on GitHub (pinned to 546686ea35)

Solutions

  1. Enable automatic deployment in the compose settings
  2. Or remove the external webhook/CI trigger
  3. Retest after toggling
Defensive patterns

Strategy: validation

Validate before calling

const compose = await db.query.compose.findFirst({ where: eq(compose.refreshToken, token) });
if (!compose?.autoDeploy) throw new Error('Enable compose auto-deploy');

Try / catch

if (res.status === 400 && body.message.includes('disabled')) { await enableComposeAutoDeploy(id); retry(); }

Prevention

When it happens

Trigger: Hitting the compose deploy webhook while the compose's automatic deploy toggle is off.

Common situations: Auto-deploy disabled intentionally (manual-only deploys) but external webhook still configured; compose recreated with defaults after config loss.

Related errors


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