[{"data":1,"prerenderedAt":344},["ShallowReactive",2],{"navigation":3,"page-\u002Ftroubleshooting\u002Freference-failures":213,"surround-\u002Ftroubleshooting\u002Freference-failures":339},[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":63,"badge":215,"body":216,"category":215,"description":333,"draft":143,"extension":334,"links":215,"meta":335,"navigation":11,"path":64,"seo":336,"sitemap":337,"stem":65,"__hash__":338},"docs\u002F11.troubleshooting\u002F4.reference-failures.md",null,{"type":217,"value":218,"toc":325},"minimark",[219,237,240,245,248,254,258,261,264,268,292,297,301,304],[220,221,222,223,227,228,232,233,236],"p",{},"A reference such as ",[224,225,226],"code",{},"${{ database.DATABASE_URL }}"," is resolved when Kuppit prepares a deployment. If it cannot be, the deployment fails before the build starts, the page says ",[229,230,231],"strong",{},"Check this service's variables, then deploy again",", and ",[229,234,235],{},"Edit variables"," takes you there. Traffic was not moved.",[220,238,239],{},"Each message below names one variable's problem. A service can have more than one; fix them all before redeploying.",[241,242,244],"h3",{"id":243},"a-variable-references-a-database-that-no-longer-exists","A variable references a database that no longer exists",[220,246,247],{},"The database the variable pointed at has been deleted. The reference is a dangling pointer, and the deployment cannot be prepared with a value that cannot exist.",[220,249,250,251,253],{},"On the ",[229,252,24],{}," tab, remove the variable, or repoint it at a database that exists in this environment. If the database was deleted by mistake, create a new one and reference that: a deleted database's data is gone, and a new reference is the only way forward.",[241,255,257],{"id":256},"a-variable-references-a-database-that-is-being-deleted","A variable references a database that is being deleted",[220,259,260],{},"The same, one step earlier: the database has a deletion in progress. It is not coming back, and Kuppit will not prepare a deployment against it.",[220,262,263],{},"Remove or repoint the variable as above. The deletion finishes on its own; nothing waits for it.",[241,265,267],{"id":266},"a-variable-references-something-the-database-does-not-expose","A variable references something the database does not expose",[220,269,270,271,274,275,274,278,274,281,274,284,287,288,291],{},"The variable names a value the database does not provide. A PostgreSQL database exposes exactly six: ",[224,272,273],{},"PGHOST",", ",[224,276,277],{},"PGPORT",[224,279,280],{},"PGUSER",[224,282,283],{},"PGPASSWORD",[224,285,286],{},"PGDATABASE"," and ",[224,289,290],{},"DATABASE_URL",". A web service exposes nothing.",[220,293,250,294,296],{},[229,295,24],{}," tab, edit the reference and choose one of the six. If you need a value that is not one of them, such as a connection string in a different shape, compose it in your application from the parts.",[241,298,300],{"id":299},"the-referenced-database-is-still-being-created","The referenced database is still being created",[220,302,303],{},"The database exists but has not finished provisioning, so it has no address or credentials to resolve to yet. This is the one message on this page that fixes itself.",[220,305,306,307,310,311,314,315,318,319,324],{},"Wait for the database's card on the environment's ",[229,308,309],{},"Overview"," to show ",[229,312,313],{},"Ready",", then ",[229,316,317],{},"Redeploy",". Provisioning takes a few minutes. A database that fails to provision says so on its own page instead, and the deployment reports ",[320,321,323],"a",{"href":322},"\u002Ftroubleshooting\u002Ffailures-that-are-kuppits#the-referenced-database-failed-to-provision","a different failure",".",{"title":326,"searchDepth":327,"depth":327,"links":328},"",3,[329,330,331,332],{"id":243,"depth":327,"text":244},{"id":256,"depth":327,"text":257},{"id":266,"depth":327,"text":267},{"id":299,"depth":327,"text":300},"A variable points at a database it cannot resolve to. Nothing was built; the fix is on the Variables tab.","md",{},{"title":63,"description":333},{"loc":64},"aU0N9h-YaCXqll8TxPqoYNcO4-PQj0_vP7gumbRaf9c",[340,342],{"title":59,"path":60,"stem":61,"description":341,"children":-1},"The image built, but the revision did not start or never answered. What the two messages mean and where to look.",{"title":67,"path":68,"stem":69,"description":343,"children":-1},"The messages that mean the problem is on Kuppit's side, what each one is, and what you can do while it is fixed.",1788549619446]