Docker Compose file rejected because it has an unknown top-level property

Error recorded 8 times in PanelAlpha Engine deploys on Docker Compose. The deploy log below is the recorded failure output.

Seen8 times
WhereDocker Compose

Why it happens

The repository was cloned successfully, but Docker Compose rejected its configuration before starting any containers. The docker-compose.yml contains a top-level app property that is not valid in the Compose schema being used. The expected application definition is typically under services.

What the log looks like

Deploy log
Detected project type: Docker ComposeUsing strategy: composeStarting application (docker compose up -d)validating /home/<account>/project/docker-compose.yml:  additional properties 'app' not allowedDeploy failed: Failed to start app: validating /home/<account>/project/docker-compose.yml:  additional properties 'app' not allowed

Try PanelAlpha Engine yourself.

The easiest way to turn your server into a safe, controlled environment for your AI agent. Deploy, manage and maintain any project from Claude Code, Cursor, Codex or any other MCP client. Open source under Apache 2.0, free to run.

Requires Ubuntu 24.04 or 26.04 · 2 GB RAM · 1 CPURead the documentation