[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"problem-detail-error-start-app-network-proxy-declared-as-external":3},{"stack":4,"error":5,"seoName":6,"seoStack":7,"seo":8,"breadcrumb":10,"titlePrefix":18,"titleAccent":19,"lead":20,"facts":23,"why":38,"log":48,"fix":65,"engine":81,"related":89,"pitch":96},"vite","start-app-network-proxy-declared-as-external","Vite deploy cannot start","Vite",{"description":9},"Learn what causes Vite deploy cannot start, how PanelAlpha Engine responds to it during deployment.",[11,14,16],{"label":12,"href":13},"App Installations","\u002Fapps",{"label":7,"href":15},"\u002Fapps\u002Fstacks\u002Fvite",{"label":17},"Vite deploy cannot start: external Docker network is missing","Vite deploy cannot start: ","external Docker network is missing",[21],{"text":22},"Error recorded 4 times in PanelAlpha Engine deploys on Vite. The deploy log below is the recorded failure output.",[24,29,32,34],{"label":25,"value":26,"tone":27,"tooltip":28},"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":30,"value":31},"Seen","4 times",{"label":33,"value":7},"Where",{"label":35,"value":36,"tooltip":37},"Status","Observed","Our team will look into this soon, verify the cause and try to fix it in an upcoming release.",{"heading":39,"body":40},"Why it happens",[41,43,46],{"text":42},"The Vite build completed successfully, but Docker Compose could not start the application. The compose configuration declares an external network named ",{"text":44,"code":45},"proxy",true,{"text":47},"; that network was not present in the Docker environment when the app started.",{"heading":49,"block":50},"What the log looks like",{"header":51,"lines":52},"Deploy log",[53,57,61],{"segments":54},[55],{"text":56},"Starting application (docker compose up -d)",{"segments":58},[59],{"text":60},"network proxy declared as external, but could not be found",{"segments":62},[63],{"text":64},"Deploy failed: Failed to start app: network proxy declared as external, but could not be found",{"heading":66,"steps":67,"block":78},"How to fix it",[68],[69,71,73,75,76],{"text":70},"Check the app's ",{"text":72,"code":45},"docker-compose.yml",{"text":74}," for the external ",{"text":44,"code":45},{"text":77}," network declaration. Create the expected Docker network in the target environment, or change the compose file to use a network managed by Compose. Then redeploy and verify that the proxy can reach the application on its configured port.",{"header":79,"lines":80},"Fix by hand",[],{"heading":82,"body":83,"block":86},"How PanelAlpha Engine solves it",[84],{"text":85},"Before running Compose, validate required external networks and report the missing network with a setup hint. Where supported, the engine could provision or attach the standard proxy network automatically.",{"header":87,"lines":88},"",[],{"heading":90,"items":91},"Apps affected",[92],{"title":93,"badge":94,"tone":27,"href":95},"kostecki-dev-landing","4 occurrences","\u002Fapps\u002Fsebastian-kostecki\u002Fkostecki-dev-landing",{"heading":97,"body":98,"footNote":99,"docsLabel":100,"docsHref":101},"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"]