[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"problem-detail-error-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":69,"engine":89,"related":97,"pitch":104},"vite","network-proxy-declared-as-external","Vite deploy failed","Vite",{"description":9},"Learn what causes Vite deploy failed, 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 failed: external Docker network is missing","Vite deploy failed: ","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. Its compose file declares a network named ",{"text":44,"code":45},"proxy",true,{"text":47}," as external, so Compose expects that network to already exist. The network was not available in the deployment environment.",{"heading":49,"block":50},"What the log looks like",{"header":51,"lines":52},"Deploy log",[53,57,61,65],{"segments":54},[55],{"text":56},"Static assets compiled",{"segments":58},[59],{"text":60},"Starting application (docker compose up -d)",{"segments":62},[63],{"text":64},"network proxy declared as external, but could not be found",{"segments":66},[67],{"text":68},"Deploy failed: Failed to start app: network proxy declared as external, but could not be found",{"heading":70,"steps":71,"block":86},"How to fix it",[72],[73,75,77,79,80,82,84],{"text":74},"Check ",{"text":76,"code":45},"docker-compose.yml",{"text":78}," for the external ",{"text":44,"code":45},{"text":81}," network declaration. Either create that network before deployment if it is required by your setup, or remove ",{"text":83,"code":45},"external: true",{"text":85}," and let Compose create a project-managed network. Redeploy after updating the compose configuration.",{"header":87,"lines":88},"Fix by hand",[],{"heading":90,"body":91,"block":94},"How PanelAlpha Engine solves it",[92],{"text":93},"Validate external Compose networks before startup and report the missing network with the compose file location. Where appropriate, offer an engine-managed network instead of failing after a successful build.",{"header":95,"lines":96},"",[],{"heading":98,"items":99},"Apps affected",[100],{"title":101,"badge":102,"tone":27,"href":103},"kostecki-dev-landing","4 occurrences","\u002Fapps\u002Fsebastian-kostecki\u002Fkostecki-dev-landing",{"heading":105,"body":106,"footNote":107,"docsLabel":108,"docsHref":109},"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"]