[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"problem-detail-error-validating-home-project-docker-compose-yml-additional-properties":3},{"stack":4,"error":5,"seoName":6,"seoStack":7,"seo":8,"breadcrumb":10,"titlePrefix":17,"titleAccent":18,"lead":19,"facts":22,"why":37,"log":55,"fix":80,"engine":112,"related":129,"pitch":136},"compose","validating-home-project-docker-compose-yml-additional-properties","Docker Compose file rejected because it has an unknown top-level property","Docker Compose",{"description":9},"Learn what causes Docker Compose file rejected because it has an unknown top-level property, how PanelAlpha Engine responds to it during deployment.",[11,14,16],{"label":12,"href":13},"App Installations","\u002Fapps",{"label":7,"href":15},"\u002Fapps\u002Fstacks\u002Fcompose",{"label":6},"Docker Compose file rejected because ","it has an unknown top-level property",[20],{"text":21},"Error recorded 8 times in PanelAlpha Engine deploys on Docker Compose. The deploy log below is the recorded failure output.",[23,28,31,33],{"label":24,"value":25,"tone":26,"tooltip":27},"Type","Error","err","An error that occurred in the deployed application. It is not necessarily a PanelAlpha Engine error, but we keep working on improvements so you run into fewer of them.",{"label":29,"value":30},"Seen","8 times",{"label":32,"value":7},"Where",{"label":34,"value":35,"tooltip":36},"Status","Observed","Our team will look into this soon, verify the cause and try to fix it in an upcoming release.",{"heading":38,"body":39},"Why it happens",[40,42,45,47,49,51,53],{"text":41},"The repository was cloned successfully, but Docker Compose rejected its configuration before starting any containers. The ",{"text":43,"code":44},"docker-compose.yml",true,{"text":46}," contains a top-level ",{"text":48,"code":44},"app",{"text":50}," property that is not valid in the Compose schema being used. The expected application definition is typically under ",{"text":52,"code":44},"services",{"text":54},".",{"heading":56,"block":57},"What the log looks like",{"header":58,"lines":59},"Deploy log",[60,64,68,72,76],{"segments":61},[62],{"text":63},"Detected project type: Docker Compose",{"segments":65},[66],{"text":67},"Using strategy: compose",{"segments":69},[70],{"text":71},"Starting application (docker compose up -d)",{"segments":73},[74],{"text":75},"validating \u002Fhome\u002F\u003Caccount>\u002Fproject\u002Fdocker-compose.yml:  additional properties 'app' not allowed",{"segments":77},[78],{"text":79},"Deploy failed: Failed to start app: validating \u002Fhome\u002F\u003Caccount>\u002Fproject\u002Fdocker-compose.yml:  additional properties 'app' not allowed",{"heading":81,"steps":82,"block":109},"How to fix it",[83],[84,86,87,89,90,92,93,95,97,99,100,102,104,106,108],{"text":85},"Open ",{"text":43,"code":44},{"text":88}," and move the application definition under ",{"text":52,"code":44},{"text":91},", or remove the unsupported ",{"text":48,"code":44},{"text":94}," property if it is not needed. Validate the file with ",{"text":96,"code":44},"docker compose config",{"text":98}," in the project directory, then redeploy. Also check that the file uses supported top-level keys such as ",{"text":52,"code":44},{"text":101},", ",{"text":103,"code":44},"volumes",{"text":105},", and ",{"text":107,"code":44},"networks",{"text":54},{"header":110,"lines":111},"Fix by hand",[],{"heading":113,"body":114,"block":126},"How PanelAlpha Engine solves it",[115,117,119,121,122,124,125],{"text":116},"Validate Compose files before attempting ",{"text":118,"code":44},"docker compose up",{"text":120},", and report the offending key with a remediation hint. Engine could optionally detect a likely misplaced ",{"text":48,"code":44},{"text":123}," definition and suggest moving it beneath ",{"text":52,"code":44},{"text":54},{"header":127,"lines":128},"",[],{"heading":130,"items":131},"Apps affected",[132],{"title":133,"badge":134,"tone":26,"href":135},"Gitlab Foss","8 occurrences","\u002Fapps\u002Fgitlab.com\u002Fgitlab-org\u002Fgitlab-foss",{"heading":137,"body":138,"footNote":139,"docsLabel":140,"docsHref":141},"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 CPU","Read the documentation","https:\u002F\u002Fpanelalpha.com\u002Fdocs"]