[{"data":1,"prerenderedAt":492},["ShallowReactive",2],{"navigation_docs_en":3,"\u002Fen\u002Freference\u002Fconfiguration":85,"\u002Fen\u002Freference\u002Fconfiguration-surround":487},[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":52,"body":87,"description":480,"extension":481,"links":482,"meta":483,"navigation":484,"path":53,"seo":485,"stem":54,"__hash__":486},"docs_en\u002Fen\u002F3.reference\u002F2.configuration.md",{"type":88,"value":89,"toc":476},"minimark",[90,115,195,200,428,438,445,449,458,469,472],[91,92,93,94,98,99,102,103,106,107,110,111,114],"p",{},"Runtime settings have the following precedence, from lowest to highest: defaults → optional ",[95,96,97],"code",{},"nix-pins.toml"," in the current directory → ",[95,100,101],{},"NIX_PINS_*"," environment variables → CLI arguments. Configuration fields, CLI arguments, and environment variables are declared once in ",[95,104,105],{},"Settings",". Clap reads CLI arguments and environment variables; config-rs merges TOML with explicitly supplied values from ",[95,108,109],{},"ArgMatches","; Serde fills in missing defaults. Pin declarations remain in ",[95,112,113],{},"pins-config.nix",".",[116,117,122],"pre",{"className":118,"code":119,"language":120,"meta":121,"style":121},"language-toml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","config = \".\u002Fpins-config.nix\"\nfile = \".\u002Fpins.json\"\ndownload_jobs = 2\nchecker_jobs = 4\nhash_jobs = 4\n","toml","",[95,123,124,147,162,174,185],{"__ignoreMap":121},[125,126,129,133,137,140,144],"span",{"class":127,"line":128},"line",1,[125,130,132],{"class":131},"sTEyZ","config ",[125,134,136],{"class":135},"sMK4o","=",[125,138,139],{"class":135}," \"",[125,141,143],{"class":142},"sfazB",".\u002Fpins-config.nix",[125,145,146],{"class":135},"\"\n",[125,148,150,153,155,157,160],{"class":127,"line":149},2,[125,151,152],{"class":131},"file ",[125,154,136],{"class":135},[125,156,139],{"class":135},[125,158,159],{"class":142},".\u002Fpins.json",[125,161,146],{"class":135},[125,163,165,168,170],{"class":127,"line":164},3,[125,166,167],{"class":131},"download_jobs ",[125,169,136],{"class":135},[125,171,173],{"class":172},"sbssI"," 2\n",[125,175,177,180,182],{"class":127,"line":176},4,[125,178,179],{"class":131},"checker_jobs ",[125,181,136],{"class":135},[125,183,184],{"class":172}," 4\n",[125,186,188,191,193],{"class":127,"line":187},5,[125,189,190],{"class":131},"hash_jobs ",[125,192,136],{"class":135},[125,194,184],{"class":172},[196,197,199],"h2",{"id":198},"fields","Fields",[201,202,203,222],"table",{},[204,205,206],"thead",{},[207,208,209,213,216,219],"tr",{},[210,211,212],"th",{},"Setting",[210,214,215],{},"Environment variable",[210,217,218],{},"CLI option",[210,220,221],{},"Default or description",[223,224,225,247,268,288,308,328,348,368,388,408],"tbody",{},[207,226,227,233,238,243],{},[228,229,230],"td",{},[95,231,232],{},"config",[228,234,235],{},[95,236,237],{},"NIX_PINS_CONFIG",[228,239,240],{},[95,241,242],{},"--config PATH",[228,244,245],{},[95,246,143],{},[207,248,249,254,259,264],{},[228,250,251],{},[95,252,253],{},"file",[228,255,256],{},[95,257,258],{},"NIX_PINS_FILE",[228,260,261],{},[95,262,263],{},"--pins PATH",[228,265,266],{},[95,267,159],{},[207,269,270,275,280,285],{},[228,271,272],{},[95,273,274],{},"download_jobs",[228,276,277],{},[95,278,279],{},"NIX_PINS_DOWNLOAD_JOBS",[228,281,282],{},[95,283,284],{},"--download-jobs N",[228,286,287],{},"2",[207,289,290,295,300,305],{},[228,291,292],{},[95,293,294],{},"checker_jobs",[228,296,297],{},[95,298,299],{},"NIX_PINS_CHECKER_JOBS",[228,301,302],{},[95,303,304],{},"--checker-jobs N",[228,306,307],{},"Half the available logical CPU count, rounded down, at least 1",[207,309,310,315,320,325],{},[228,311,312],{},[95,313,314],{},"hash_jobs",[228,316,317],{},[95,318,319],{},"NIX_PINS_HASH_JOBS",[228,321,322],{},[95,323,324],{},"--hash-jobs N",[228,326,327],{},"Same as above",[207,329,330,335,340,345],{},[228,331,332],{},[95,333,334],{},"github_api_base",[228,336,337],{},[95,338,339],{},"NIX_PINS_GITHUB_API_BASE",[228,341,342],{},[95,343,344],{},"--github-api-base URL",[228,346,347],{},"Official GitHub API",[207,349,350,355,360,365],{},[228,351,352],{},[95,353,354],{},"crates_api_base",[228,356,357],{},[95,358,359],{},"NIX_PINS_CRATES_API_BASE",[228,361,362],{},[95,363,364],{},"--crates-api-base URL",[228,366,367],{},"Official crates.io API",[207,369,370,375,380,385],{},[228,371,372],{},[95,373,374],{},"pypi_api_base",[228,376,377],{},[95,378,379],{},"NIX_PINS_PYPI_API_BASE",[228,381,382],{},[95,383,384],{},"--pypi-api-base URL",[228,386,387],{},"Official PyPI API",[207,389,390,395,400,405],{},[228,391,392],{},[95,393,394],{},"npm_registry_base",[228,396,397],{},[95,398,399],{},"NIX_PINS_NPM_REGISTRY_BASE",[228,401,402],{},[95,403,404],{},"--npm-registry-base URL",[228,406,407],{},"Official npm registry",[207,409,410,415,420,425],{},[228,411,412],{},[95,413,414],{},"github_token",[228,416,417],{},[95,418,419],{},"NIX_PINS_GITHUB_TOKEN",[228,421,422],{},[95,423,424],{},"--github-token TOKEN",[228,426,427],{},"Optional GitHub token",[91,429,430,431,434,435,437],{},"Concurrency values must be positive integers. Invalid configuration fails before Nix starts. Empty environment variables are treated as unset. ",[95,432,433],{},"GITHUB_TOKEN"," can also supply a token, with lower priority than the configuration file and ",[95,436,419],{},". Do not put tokens in configuration files committed to version control.",[91,439,440,441,444],{},"CLI options can appear before or after the subcommand. ",[95,442,443],{},"nix-pins update --help"," lists all settings, their environment variables, and default descriptions. Token environment variable values are not shown in help.",[196,446,448],{"id":447},"concurrency-queues","Concurrency queues",[91,450,451,452,454,455,457],{},"Once all version checks finish, Pins process their Sources and dependencies independently. Source downloads are limited by ",[95,453,274],{},"; Nix evaluation and dependency builds share the ",[95,456,314],{}," limit. A Pin can enter the build queue as soon as its sources are ready. Multiple Sources in one Pin share these queues too.",[91,459,460,461,464,465,468],{},"Successful Pins immediately show ",[95,462,463],{},"✔","; failed Pins retain their previous results. A Pin updates only when every Source succeeds. Results are written together atomically at the end; cancellation writes nothing. Because downloads and builds can overlap, the overall phase is labeled ",[95,466,467],{},"Processing pins",", with each node showing its specific step.",[91,470,471],{},"Increasing concurrency raises simultaneous network, Nix store, and CPU usage. If you encounter rate limits or local resource pressure, reduce the corresponding concurrency setting first.",[473,474,475],"style",{},"html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":121,"searchDepth":149,"depth":149,"links":477},[478,479],{"id":198,"depth":149,"text":199},{"id":447,"depth":149,"text":448},"nix-pins.toml, environment variables, paths, and concurrency settings.","md",null,{},true,{"title":52,"description":480},"QvBVJplia8nnqqZTHi4osglokKIVUnIQu7ccvfGnGGc",[488,490],{"title":48,"path":49,"stem":50,"description":489,"children":-1},"Commands, name and regex selection, and global runtime options.",{"title":56,"path":57,"stem":58,"description":491,"children":-1},"pin.mk, pin.github, pin.git, and the relationship between Pins, Sources, and Packages.",1791031184505]