Dokploy/dokploy · error · TRPCError

NOT_FOUND

NOT_FOUND

Error message

No servers available, Please subscribe to a plan

What it means

Cloud-only gate in project.create: the account owner's serversQuantity is 0 and IS_CLOUD is true, so there is no server quota to place the project on. Dokploy Cloud requires an active plan with at least one server slot before creating projects.

Source

Thrown at apps/dokploy/server/api/routers/project.ts:79

	mariadb,
	mongo,
	mysql,
	postgres,
	projects,
	redis,
} from "@/server/db/schema";

export const projectRouter = createTRPCRouter({
	create: protectedProcedure
		.input(apiCreateProject)
		.mutation(async ({ ctx, input }) => {
			try {
				await checkProjectAccess(ctx, "create");

				const admin = await findUserById(ctx.user.ownerId);

				if (admin.serversQuantity === 0 && IS_CLOUD) {
					throw new TRPCError({
						code: "NOT_FOUND",
						message: "No servers available, Please subscribe to a plan",
					});
				}

				const project = await createProject(
					input,
					ctx.session.activeOrganizationId,
				);
				await addNewProject(ctx, project.project.projectId);

				await addNewEnvironment(ctx, project?.environment?.environmentId || "");

				await audit(ctx, {
					action: "create",
					resourceType: "project",
					resourceId: project.project.projectId,
					resourceName: project.project.name,

View on GitHub (pinned to 546686ea35)

Solutions

1. Subscribe to a Dokploy Cloud plan that includes at least one server
2. If self-hosted, this check is skipped (IS_CLOUD false) — verify your build/flags if it fires unexpectedly
3. After subscribing, retry project creation

if (isCloud) {
  const admin = await api.user.me.query();
  if (admin.serversQuantity === 0) throw new Error('Subscribe to a plan first');
}

When it happens

Trigger: Calling project.create on Dokploy Cloud when the billing plan has no server allocation (serversQuantity === 0).

Common situations: New cloud account before subscribing; plan expired or downgraded to free tier with zero servers.

Related errors

• UNAUTHORIZED
• BAD_REQUEST
• UNAUTHORIZED
• FORBIDDEN
• NOT_FOUND

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