[{"data":1,"prerenderedAt":406},["ShallowReactive",2],{"navigation":3,"page-\u002Ftroubleshooting":213,"surround-\u002Ftroubleshooting":401},[4,17,48,79,95,118,133,144,155,167,186],{"title":5,"path":6,"stem":7,"children":8,"icon":16,"exact":11},"Getting started","\u002Fgetting-started","1.getting-started\u002F1.index",[9,12],{"title":10,"path":6,"stem":7,"exact":11,"children":-1},"Introduction",true,{"title":13,"path":14,"stem":15,"exact":11,"children":-1},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart","i-lucide-rocket",{"title":18,"path":19,"stem":20,"children":21,"icon":47,"exact":11},"Reference","\u002Freference","10.reference\u002F1.index",[22,23,27,31,35,39,43],{"title":18,"path":19,"stem":20,"exact":11,"children":-1},{"title":24,"path":25,"stem":26,"exact":11,"children":-1},"Variables","\u002Freference\u002Fvariables","10.reference\u002F2.variables",{"title":28,"path":29,"stem":30,"exact":11,"children":-1},"Hostnames and DNS","\u002Freference\u002Fhostnames-and-dns","10.reference\u002F3.hostnames-and-dns",{"title":32,"path":33,"stem":34,"exact":11,"children":-1},"Statuses","\u002Freference\u002Fstatuses","10.reference\u002F4.statuses",{"title":36,"path":37,"stem":38,"exact":11,"children":-1},"Limits","\u002Freference\u002Flimits","10.reference\u002F5.limits",{"title":40,"path":41,"stem":42,"exact":11,"children":-1},"Sizes","\u002Freference\u002Fsizes","10.reference\u002F6.sizes",{"title":44,"path":45,"stem":46,"exact":11,"children":-1},"The GitHub App","\u002Freference\u002Fgithub-app","10.reference\u002F7.github-app","i-lucide-book-open",{"title":49,"path":50,"stem":51,"children":52,"icon":78,"exact":11},"Troubleshooting","\u002Ftroubleshooting","11.troubleshooting\u002F1.index",[53,54,58,62,66,70,74],{"title":49,"path":50,"stem":51,"exact":11,"children":-1},{"title":55,"path":56,"stem":57,"exact":11,"children":-1},"Build failures","\u002Ftroubleshooting\u002Fbuild-failures","11.troubleshooting\u002F2.build-failures",{"title":59,"path":60,"stem":61,"exact":11,"children":-1},"Start and health failures","\u002Ftroubleshooting\u002Fstart-and-health-failures","11.troubleshooting\u002F3.start-and-health-failures",{"title":63,"path":64,"stem":65,"exact":11,"children":-1},"Reference failures","\u002Ftroubleshooting\u002Freference-failures","11.troubleshooting\u002F4.reference-failures",{"title":67,"path":68,"stem":69,"exact":11,"children":-1},"Failures that are Kuppit's","\u002Ftroubleshooting\u002Ffailures-that-are-kuppits","11.troubleshooting\u002F5.failures-that-are-kuppits",{"title":71,"path":72,"stem":73,"exact":11,"children":-1},"Domain issues","\u002Ftroubleshooting\u002Fdomain-issues","11.troubleshooting\u002F6.domain-issues",{"title":75,"path":76,"stem":77,"exact":11,"children":-1},"No preview for a pull request","\u002Ftroubleshooting\u002Fno-preview-for-a-pull-request","11.troubleshooting\u002F7.no-preview-for-a-pull-request","i-lucide-life-buoy",{"title":80,"path":81,"stem":82,"children":83,"icon":94,"exact":11},"Concepts","\u002Fconcepts","2.concepts\u002F1.index",[84,86,90],{"title":85,"path":81,"stem":82,"exact":11,"children":-1},"The Kuppit model",{"title":87,"path":88,"stem":89,"exact":11,"children":-1},"The application graph","\u002Fconcepts\u002Fthe-application-graph","2.concepts\u002F2.the-application-graph",{"title":91,"path":92,"stem":93,"exact":11,"children":-1},"How a service runs","\u002Fconcepts\u002Fhow-a-service-runs","2.concepts\u002F3.how-a-service-runs","i-lucide-shapes",{"title":96,"path":97,"stem":98,"children":99,"icon":117,"exact":11},"Deployments","\u002Fdeployments","3.deployments\u002F1.index",[100,101,105,109,113],{"title":96,"path":97,"stem":98,"exact":11,"children":-1},{"title":102,"path":103,"stem":104,"exact":11,"children":-1},"Builds","\u002Fdeployments\u002Fbuilds","3.deployments\u002F2.builds",{"title":106,"path":107,"stem":108,"exact":11,"children":-1},"Redeploy and roll back","\u002Fdeployments\u002Fredeploy-and-rollback","3.deployments\u002F3.redeploy-and-rollback",{"title":110,"path":111,"stem":112,"exact":11,"children":-1},"Logs","\u002Fdeployments\u002Flogs","3.deployments\u002F4.logs",{"title":114,"path":115,"stem":116,"exact":11,"children":-1},"When a deployment fails","\u002Fdeployments\u002Fwhen-a-deployment-fails","3.deployments\u002F5.when-a-deployment-fails","i-lucide-cloud-upload",{"title":119,"path":120,"stem":121,"children":122,"icon":132,"exact":11},"Resources","\u002Fresources","4.resources\u002F1.index",[123,124,128],{"title":119,"path":120,"stem":121,"exact":11,"children":-1},{"title":125,"path":126,"stem":127,"exact":11,"children":-1},"Web services","\u002Fresources\u002Fweb-services","4.resources\u002F2.web-services",{"title":129,"path":130,"stem":131,"exact":11,"children":-1},"PostgreSQL","\u002Fresources\u002Fpostgresql","4.resources\u002F3.postgresql","i-lucide-boxes",{"title":134,"icon":135,"path":136,"stem":137,"children":138,"page":143,"exact":11},"Configuration","i-lucide-sliders-horizontal","\u002Fconfiguration","5.configuration",[139],{"title":140,"path":141,"stem":142,"exact":11,"children":-1},"Environment variables","\u002Fconfiguration\u002Fvariables","5.configuration\u002F1.variables",false,{"title":145,"path":146,"stem":147,"children":148,"icon":154,"exact":11},"Networking","\u002Fnetworking","6.networking\u002F1.index",[149,150],{"title":145,"path":146,"stem":147,"exact":11,"children":-1},{"title":151,"path":152,"stem":153,"exact":11,"children":-1},"Reaching a database","\u002Fnetworking\u002Freaching-a-database","6.networking\u002F2.reaching-a-database","i-lucide-network",{"title":156,"path":157,"stem":158,"children":159,"icon":166,"exact":11},"Domains","\u002Fdomains","7.domains\u002F1.index",[160,162],{"title":161,"path":157,"stem":158,"exact":11,"children":-1},"Hostnames",{"title":163,"path":164,"stem":165,"exact":11,"children":-1},"Custom domains","\u002Fdomains\u002Fcustom-domains","7.domains\u002F2.custom-domains","i-lucide-globe",{"title":168,"path":169,"stem":170,"children":171,"icon":185,"exact":11},"Environments","\u002Fenvironments","8.environments\u002F1.index",[172,173,177,181],{"title":168,"path":169,"stem":170,"exact":11,"children":-1},{"title":174,"path":175,"stem":176,"exact":11,"children":-1},"Preview environments","\u002Fenvironments\u002Fpreview-environments","8.environments\u002F2.preview-environments",{"title":178,"path":179,"stem":180,"exact":11,"children":-1},"Named environments","\u002Fenvironments\u002Fnamed-environments","8.environments\u002F3.named-environments",{"title":182,"path":183,"stem":184,"exact":11,"children":-1},"Deleting an environment","\u002Fenvironments\u002Fdeleting-an-environment","8.environments\u002F4.deleting-an-environment","i-lucide-git-branch",{"title":187,"path":188,"stem":189,"children":190,"icon":212,"exact":11},"Guides","\u002Fguides","9.guides\u002F1.index",[191,192,196,200,204,208],{"title":187,"path":188,"stem":189,"exact":11,"children":-1},{"title":193,"path":194,"stem":195,"exact":11,"children":-1},"Deploy a Nuxt application","\u002Fguides\u002Fdeploy-a-nuxt-application","9.guides\u002F2.deploy-a-nuxt-application",{"title":197,"path":198,"stem":199,"exact":11,"children":-1},"Deploy a Next.js application","\u002Fguides\u002Fdeploy-a-nextjs-application","9.guides\u002F3.deploy-a-nextjs-application",{"title":201,"path":202,"stem":203,"exact":11,"children":-1},"Deploy an Express application","\u002Fguides\u002Fdeploy-an-express-application","9.guides\u002F4.deploy-an-express-application",{"title":205,"path":206,"stem":207,"exact":11,"children":-1},"Deploy with a Dockerfile","\u002Fguides\u002Fdeploy-with-a-dockerfile","9.guides\u002F5.deploy-with-a-dockerfile",{"title":209,"path":210,"stem":211,"exact":11,"children":-1},"Create a staging environment","\u002Fguides\u002Fcreate-a-staging-environment","9.guides\u002F6.create-a-staging-environment","i-lucide-map",{"id":214,"title":49,"badge":215,"body":216,"category":215,"description":395,"draft":143,"extension":396,"links":215,"meta":397,"navigation":11,"path":50,"seo":398,"sitemap":399,"stem":51,"__hash__":400},"docs\u002F11.troubleshooting\u002F1.index.md",null,{"type":217,"value":218,"toc":387},"minimark",[219,223,228,231,281,284,287,344,348],[220,221,222],"p",{},"When a deployment fails, a domain will not go active, or a pull request gets no preview, Kuppit says why in one sentence. These pages take each sentence and say what happened behind it, what to check, and how to fix it. The failure page in the dashboard links to the matching entry.",[224,225,227],"h2",{"id":226},"reading-a-failed-deployment","Reading a failed deployment",[220,229,230],{},"A failed deployment's page opens with the failure, above the phases:",[232,233,234,247,250,269,275],"ul",{},[235,236,237,238,242,243,246],"li",{},"The title is ",[239,240,241],"strong",{},"Build failed"," when the image could not be built, and ",[239,244,245],{},"Deployment failed"," otherwise.",[235,248,249],{},"One sentence names the cause. The same sentence heads its entry here.",[235,251,252,253,256,257,260,261,264,265,268],{},"The sentence is followed by whose problem it is. Your application's failures offer ",[239,254,255],{},"View relevant logs",", which opens the stream that failed with errors selected. Failures you fix on the Variables tab say ",[239,258,259],{},"Check this service's variables, then deploy again"," and offer ",[239,262,263],{},"Edit variables",". Kuppit's own say ",[239,266,267],{},"This is Kuppit's to fix, not something in your repository",".",[235,270,271,274],{},[239,272,273],{},"Advanced details"," holds the infrastructure's own error code and message, for when the sentence is not enough.",[235,276,277,280],{},[239,278,279],{},"Redeploy"," builds the same commit again with the service's current settings and variables.",[220,282,283],{},"Whatever failed, traffic was not moved. The deployment that was serving keeps serving.",[224,285,96],{"id":286},"deployments",[288,289,290,303],"table",{},[291,292,293],"thead",{},[294,295,296,300],"tr",{},[297,298,299],"th",{},"It says",[297,301,302],{},"Go to",[304,305,306,317,326,335],"tbody",{},[294,307,308,312],{},[309,310,311],"td",{},"The Dockerfile Kuppit was told to build no longer exists · Build settings no longer match the repository · The repository is too large for Kuppit to build · The repository source could not be read · The build failed · The build ran out of time",[309,313,314],{},[315,316,55],"a",{"href":56},[294,318,319,322],{},[309,320,321],{},"The new revision could not start · The application did not become healthy",[309,323,324],{},[315,325,59],{"href":60},[294,327,328,331],{},[309,329,330],{},"A variable references a database that no longer exists · … that is being deleted · … something the database does not expose · The referenced database is still being created",[309,332,333],{},[315,334,63],{"href":64},[294,336,337,340],{},[309,338,339],{},"Kuppit encountered an internal build error · Kuppit lost track of the build · Traffic did not move to the new revision · The deployment stopped making progress · and the rest that are Kuppit's",[309,341,342],{},[315,343,67],{"href":68},[224,345,347],{"id":346},"domains-and-previews","Domains and previews",[232,349,350,374],{},[235,351,352,353,356,357,356,360,363,364,367,368,371,372,268],{},"A custom domain stuck at ",[239,354,355],{},"Needs ownership",", ",[239,358,359],{},"Needs routing",[239,361,362],{},"Securing",", or showing ",[239,365,366],{},"DNS issue"," or ",[239,369,370],{},"Failed",": ",[315,373,71],{"href":72},[235,375,376,377,380,381,384,385,268],{},"A pull request whose check says ",[239,378,379],{},"No preview",", or has no ",[239,382,383],{},"Kuppit Preview"," check at all: ",[315,386,75],{"href":76},{"title":388,"searchDepth":389,"depth":389,"links":390},"",3,[391,393,394],{"id":226,"depth":392,"text":227},2,{"id":286,"depth":392,"text":96},{"id":346,"depth":392,"text":347},"Every message Kuppit shows when something goes wrong, what it means, and what to do about it.","md",{},{"title":49,"description":395},{"loc":50},"YrTQfNiQ_eJdsAoNLxsDbKrrUPVcdR8W6b28zk-rX50",[402,404],{"title":44,"path":45,"stem":46,"description":403,"children":-1},"What Kuppit's GitHub App is granted on a repository, which events it listens to, and what each is for.",{"title":55,"path":56,"stem":57,"description":405,"children":-1},"The six ways turning a commit into an image can fail, and what to do about each.",1788549618224]