[{"data":1,"prerenderedAt":307},["ShallowReactive",2],{"navigation_docs_en":3,"\u002Fen\u002Ftroubleshooting\u002Fcommon-errors":85,"\u002Fen\u002Ftroubleshooting\u002Fcommon-errors-surround":304},[4,19,41,75],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":18},"Getting started","i-lucide-book-open","\u002Fen\u002Fgetting-started","en\u002F1.getting-started",[10,14],{"title":11,"path":12,"stem":13},"Installation","\u002Fen\u002Fgetting-started\u002Finstallation","en\u002F1.getting-started\u002F1.installation",{"title":15,"path":16,"stem":17},"Your first Pin","\u002Fen\u002Fgetting-started\u002Ffirst-pin","en\u002F1.getting-started\u002F2.first-pin",false,{"title":20,"icon":21,"path":22,"stem":23,"children":24,"page":18},"Guides","i-lucide-route","\u002Fen\u002Fguides","en\u002F2.guides",[25,29,33,37],{"title":26,"path":27,"stem":28},"Updating and selecting Pins","\u002Fen\u002Fguides\u002Fupdating","en\u002F2.guides\u002F1.updating",{"title":30,"path":31,"stem":32},"Combining Checkers and Fetchers","\u002Fen\u002Fguides\u002Fcombinations","en\u002F2.guides\u002F2.combinations",{"title":34,"path":35,"stem":36},"Multiple Sources and patches","\u002Fen\u002Fguides\u002Fmulti-source","en\u002F2.guides\u002F3.multi-source",{"title":38,"path":39,"stem":40},"Packages and dependency hashes","\u002Fen\u002Fguides\u002Fdependencies","en\u002F2.guides\u002F4.dependencies",{"title":42,"icon":43,"path":44,"stem":45,"children":46,"page":18},"Reference","i-lucide-code","\u002Fen\u002Freference","en\u002F3.reference",[47,51,55,59,63,67,71],{"title":48,"path":49,"stem":50},"CLI","\u002Fen\u002Freference\u002Fcli","en\u002F3.reference\u002F1.cli",{"title":52,"path":53,"stem":54},"Runtime configuration","\u002Fen\u002Freference\u002Fconfiguration","en\u002F3.reference\u002F2.configuration",{"title":56,"path":57,"stem":58},"Pin declarations","\u002Fen\u002Freference\u002Fpins","en\u002F3.reference\u002F3.pins",{"title":60,"path":61,"stem":62},"Checkers","\u002Fen\u002Freference\u002Fcheckers","en\u002F3.reference\u002F4.checkers",{"title":64,"path":65,"stem":66},"Fetchers","\u002Fen\u002Freference\u002Ffetchers","en\u002F3.reference\u002F5.fetchers",{"title":68,"path":69,"stem":70},"Package Builders","\u002Fen\u002Freference\u002Fbuilders","en\u002F3.reference\u002F6.builders",{"title":72,"path":73,"stem":74},"Reader and Pins File","\u002Fen\u002Freference\u002Freader","en\u002F3.reference\u002F7.reader",{"title":76,"icon":77,"path":78,"stem":79,"children":80,"page":18},"Troubleshooting","i-lucide-wrench","\u002Fen\u002Ftroubleshooting","en\u002F4.troubleshooting",[81],{"title":82,"path":83,"stem":84},"Common errors","\u002Fen\u002Ftroubleshooting\u002Fcommon-errors","en\u002F4.troubleshooting\u002F1.common-errors",{"id":86,"title":82,"body":87,"description":297,"extension":298,"links":299,"meta":300,"navigation":301,"path":83,"seo":302,"stem":84,"__hash__":303},"docs_en\u002Fen\u002F4.troubleshooting\u002F1.common-errors.md",{"type":88,"value":89,"toc":287},"minimark",[90,99,104,160,163,167,174,193,204,208,218,225,229,248,251,255,270,274,277],[91,92,93,94,98],"p",{},"Keep the full error text, then distinguish a configuration error from a runtime failure in a specific Pin. ",[95,96,97],"code",{},"nix-pins status"," shows existing results and the last recorded failures.",[100,101,103],"h2",{"id":102},"configuration-fails-to-load","Configuration fails to load",[105,106,107,119,129,139,154],"ul",{},[108,109,110,111,114,115,118],"li",{},"Check the current working directory, ",[95,112,113],{},"--config",", and ",[95,116,117],{},"--pins",".",[108,120,121,122,125,126,118],{},"Confirm ",[95,123,124],{},"\u003Cnixpkgs>"," resolves by running ",[95,127,128],{},"nix eval --impure --raw --expr 'toString \u003Cnixpkgs>'",[108,130,131,132,135,136,118],{},"Check target fields: do not mix ",[95,133,134],{},"target"," with legacy fields; GitHub targets must use ",[95,137,138],{},"owner\u002Frepo",[108,140,141,142,145,146,149,150,153],{},"URLs for ",[95,143,144],{},"pin.fetcher.url"," and ",[95,147,148],{},"pin.fetcher.zip"," must be functions such as ",[95,151,152],{},"version: \"https:\u002F\u002F...\"",", not plain strings.",[108,155,156,159],{},[95,157,158],{},"rev"," mappings must also return strings. Unsupported fields cause errors.",[91,161,162],{},"Deterministic configuration errors occur before Checkers run. Fix the declaration, then update again.",[100,164,166],{"id":165},"version-checks-fail","Version checks fail",[91,168,169,170,173],{},"GitHub 403 or 429 responses may indicate API rate limits. Supply a token as described in ",[171,172,52],"a",{"href":53},". Do not write tokens into files you will commit.",[91,175,176,177,180,181,184,185,188,189,192],{},"Git checks rely on ",[95,178,179],{},"git ls-remote",". Check connectivity, repository permissions, and ",[95,182,183],{},"mode",". Branch mode requires ",[95,186,187],{},"branch","; ref mode requires ",[95,190,191],{},"ref",". If tag mode has no candidates, check the regular expressions and whether the repository has matching tags.",[91,194,195,196,199,200,203],{},"The npm Checker reads ",[95,197,198],{},"dist-tags"," and fails if the requested ",[95,201,202],{},"distTag"," does not exist. For URL Checker mismatches, inspect the response text and regex. Command Checkers must exit successfully and print a nonempty version.",[100,205,207],{"id":206},"source-fetching-fails","Source fetching fails",[91,209,210,211,213,214,217],{},"Check that the original Version from the Checker corresponds to the upstream tag, commit ID, or filename. Registry versions may need a ",[95,212,158],{}," or ",[95,215,216],{},"url"," mapping. Do not edit the version in the Pins File to work around configuration problems.",[91,219,220,221,224],{},"Confirm that your Nixpkgs provides the Fetcher, especially ",[95,222,223],{},"fetchFromHuggingFace",". Large models, submodules, and restricted repositories also need sufficient storage, connectivity, and credentials.",[100,226,228],{"id":227},"dependency-hashing-fails","Dependency hashing fails",[91,230,231,232,235,236,239,240,243,244,247],{},"Check the Package's ",[95,233,234],{},"root"," and lockfile location. npm requires ",[95,237,238],{},"package-lock.json",". pnpm requires a compatible ",[95,241,242],{},"pnpm-lock.yaml",", an explicit ",[95,245,246],{},"fetcherVersion",", and the same pnpm version used downstream.",[91,249,250],{},"Prefetching dependencies executes the intermediate FOD's build steps. A failure does not necessarily mean the final application's build is broken. Inspect the Source, Package, and dependency Hash identified in the output, then update only the affected Pin.",[100,252,254],{"id":253},"reader-fails","Reader fails",[91,256,257,258,261,262,265,266,269],{},"Confirm that the Pins File uses schema v2 and that you access ",[95,259,260],{},"pins.\u003Cpin>.sources.\u003Csource>.src",". Supply ",[95,263,264],{},"config"," when you need ",[95,267,268],{},"packages"," or patched sources. After changing configuration, update the Pins File to keep declarations and locked results consistent.",[100,271,273],{"id":272},"concurrent-runs-and-cancellation","Concurrent runs and cancellation",[91,275,276],{},"A write-lock conflict means another process is updating the same Pins File. Wait for it to finish before retrying; do not bypass the lock while a writer is active. Cancellation does not write results from the current run, and the existing Pins File remains usable.",[91,278,279,280,145,283,286],{},"If downloads and builds exhaust local resources, reduce ",[95,281,282],{},"download_jobs",[95,284,285],{},"hash_jobs",". Interactive TUI and CI text output differ. Use exit codes, error text, and the Pins File to determine the outcome.",{"title":288,"searchDepth":289,"depth":289,"links":290},"",2,[291,292,293,294,295,296],{"id":102,"depth":289,"text":103},{"id":165,"depth":289,"text":166},{"id":206,"depth":289,"text":207},{"id":227,"depth":289,"text":228},{"id":253,"depth":289,"text":254},{"id":272,"depth":289,"text":273},"Diagnose configuration, version checks, source fetching, dependency hashes, and Reader failures.","md",null,{},true,{"title":82,"description":297},"Xq4wgSI2gx3l4hIwFeD3SCfMdp9g4xZ5mTfPsxAOCU4",[305,299],{"title":72,"path":73,"stem":74,"description":306,"children":-1},"Restore source code, patches, and named Packages from locked JSON results.",1791031185308]