[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"problem-detail-error-build-failed-with-an-exception":3},{"stack":4,"error":5,"seoName":6,"seoStack":7,"seo":8,"breadcrumb":10,"titlePrefix":17,"titleAccent":18,"lead":19,"facts":22,"why":37,"log":51,"fix":96,"engine":109,"related":117,"pitch":130},"java","build-failed-with-an-exception","Java Gradle build failed because npm is missing","Java",{"description":9},"Learn what causes Java Gradle build failed because npm is missing, how PanelAlpha Engine responds to it during deployment.",[11,14,16],{"label":12,"href":13},"App Installations","\u002Fapps",{"label":7,"href":15},"\u002Fapps\u002Fstacks\u002Fjava",{"label":6},"Java Gradle build failed because ","npm is missing",[20],{"text":21},"Error recorded 7 times in PanelAlpha Engine deploys on Java. 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","7 times · 6 variants",{"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],{"text":41},"The Java\u002FGradle build evaluates ",{"text":43,"code":44},"\u002Fapp\u002Fgradle\u002Futils.gradle",true,{"text":46},", which requires the ",{"text":48,"code":44},"npm",{"text":50}," executable. The selected Gradle image contains Java and Gradle but does not have npm on its PATH. The build stops before the application can start.",{"heading":52,"block":53},"What the log looks like",{"header":54,"lines":55},"Deploy log",[56,60,64,68,72,76,80,84,88,92],{"segments":57},[58],{"text":59},"Detected project type: Java (Gradle)",{"segments":61},[62],{"text":63},"Using strategy: java",{"segments":65},[66],{"text":67},"Loaded base image gradle:8-jdk21 from host cache",{"segments":69},[70],{"text":71},"Compiling application on host",{"segments":73},[74],{"text":75},"FAILURE: Build failed with an exception.",{"segments":77},[78],{"text":79},"* Where:",{"segments":81},[82],{"text":83},"Script '\u002Fapp\u002Fgradle\u002Futils.gradle' line: 11",{"segments":85},[86],{"text":87},"* What went wrong:",{"segments":89},[90],{"text":91},"> npm executable not found. Install it and ensure it is on PATH (lookup used 'which npm').",{"segments":93},[94],{"text":95},"BUILD FAILED in 40s",{"heading":97,"steps":98,"block":106},"How to fix it",[99],[100,102,104],{"text":101},"Use a build image or strategy that includes both Java and Node.js\u002Fnpm. Alternatively, install npm in the build environment and verify that ",{"text":103,"code":44},"which npm",{"text":105}," succeeds before running Gradle. If the repository expects a different build path, review its Gradle and Docker Compose configuration and select the matching strategy.",{"header":107,"lines":108},"Fix by hand",[],{"heading":110,"body":111,"block":114},"How PanelAlpha Engine solves it",[112],{"text":113},"Detect when a Gradle build invokes npm and provision a compatible Node.js\u002Fnpm toolchain, or fail during preparation with a clear missing-tool message and suggested build image.",{"header":115,"lines":116},"",[],{"heading":118,"items":119},"Apps affected",[120,124,127],{"title":121,"badge":122,"tone":26,"href":123},"Komf","2 occurrences","\u002Fapps\u002Fsnd-r\u002Fkomf",{"title":125,"badge":122,"tone":26,"href":126},"Kuvasz","\u002Fapps\u002Fkuvasz-uptime\u002Fkuvasz",{"title":128,"badge":122,"tone":26,"href":129},"Tolgee Platform","\u002Fapps\u002Ftolgee\u002Ftolgee-platform",{"heading":131,"body":132,"footNote":133,"docsLabel":134,"docsHref":135},"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"]