1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="utf-8">
<meta name="generator" content="Docutils 0.22.4: https://docutils.sourceforge.io/">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta content="Nixtamal, Nix, Git, Codeberg, mirrors, mirroring, input pinning, dependency management" name="keywords">
<meta content="How to pin a Codeberg repository with Nixtamal + Nix" name="description">
<meta name="author" content="toastal">
<meta name="dcterms.date" content="2026-03-01">
<link rel="schema.dcterms" href="http://purl.org/dc/terms/">
<meta content="" name="robots">
<title>
Pinning Inputs with Mirrors | Nixtamal
</title>
<meta name="generator" content="soupault">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta http-equiv="X-XSS-Protection" content="1;mode=block">
<meta http-equiv="X-Content-Type-Options" content="nosniff">
<meta http-equiv="Content-Security-Policy" content="default-src 'self';">
<meta http-equiv="Referrer-Policy" content="strict-origin-when-cross-origin">
<meta name="theme" content="crimson">
<link rel="icon" type="image/svg+xml" href="/asset/_hashed/nixtamal/image/nixtamal-logo-gmxzsw8388sf9paq05xws7an4hnl4nx0.svg">
<link rel="stylesheet" href="/asset/_hashed/nixtamal/style/font-j47xx20z5d89qpsl95nnbipkg6d25m6y.css">
<link rel="stylesheet" href="/asset/_hashed/sugilite256/chroma-light-yfrfnk1zyqm9dc67gaa5y67s0a6x40ji.css">
<link rel="stylesheet" href="/asset/_hashed/sugilite256/chroma-dark-s4ssx3zwz2w418zx7pkrqlwqmywgvahl.css" media="(prefers-color-scheme: dark)">
<link rel="stylesheet" href="/asset/_hashed/nixtamal/style/main-lmdn1rci18371fnrcqrwga636ip08irz.css">
<link rel="author" href="/humans.txt">
</head>
<body>
<div id="DocWrapper" class="DocWrapper">
<div class="Banner-wrapper">
<header id="Banner" class="Banner">
<pre role="none" class="Banner-flair">âââ»+â» â±ââ³âââââ³ââââ»
ââââââââ¹ââ¹â£â«ââââ£â«â
â¹âââ¹â± â¹ â¹ â¹â¹â¹ â¹â¹â¹ââ</pre>
<a href="/" class="SiteLogo" title="Home">
<svg viewbox="0 0 79.375 27.099415" class="SiteLogo-image" role="img" aria-labelledby="SiteLogo-desc">
<use href="/asset/_hashed/nixtamal/image/nixtamal-logo-gmxzsw8388sf9paq05xws7an4hnl4nx0.svg#logo">
<desc id="SiteLogo-desc">
Home
</desc>
</use>
</svg>
</a>
<nav id="Navigation" class="Banner-navigation Navigation Navigation--banner" aria-expanded="true">
<a class="Navigation-item" href="/install/">Install</a>
<a class="Navigation-item" href="/manpage/">Manpage</a>
<a class="Navigation-item" href="/changelog/">Changelog</a>
<a class="Navigation-item" href="/roadmap/">Roadmap</a>
<a class="Navigation-item" href="/cookbook/">Cookbook</a>
<a class="Navigation-item" href="/real-world-showcase/">Real-world showcase</a>
<a class="Navigation-item" href="/community/">Community</a>
<a class="Navigation-item" href="/faqs/"><abbr title="frequently asked questions">FAQs</abbr></a>
<a class="Navigation-item" href="/funding/">Funding</a>
</nav>
</header>
<hr class="Banner-separator">
</div>
<main id="Main" class="Main">
<article id="Article" class="Article Stack">
<header class="Headline Article-headline">
<h1 itemprop="headline" class="title">
Pinning Inputs with Mirrors
</h1>
</header>
<section itemprop="articleBody" id="Content" class="Content Article-body">
<p>
Mirrors are a very good idea for project to have.
</p>
<ul class="simple">
<li>
<p>
Increases project resiliance as all servers go down so ideally <em>something</em> should be online to fallback to
</p>
</li>
<li>
<p>
Helps accessibility as some regions block users based on sanctions & others might not agree to the terms of service or privacy laws in the jurisdiction of some options
</p>
</li>
<li>
<p>
If self-hosted, then you/your project owns the codeâââwhich can help with potential censorship
</p>
</li>
</ul>
<p>
At the time of writing, Nix flakes does not & cannot support mirrors in input pinning requiring an input pinner like <a class="reference external" href="https://nixtamal.toast.al/"><cite>Nixtamal</cite></a> to automate it.
</p>
<section id="how-to-pin-a-repository-with-mirrors-in-nix-nixtamal">
<h2>
How to pin a repository with mirrors in Nix + Nixtamal
</h2>
<p>
Mirrors are not supported on all kinds (fetcher limitations) however these can be supported:
</p>
<ul class="simple">
<li>
<p>
File
</p>
</li>
<li>
<p>
Archive
</p>
</li>
<li>
<p>
Darcs
</p>
</li>
<li>
<p>
Pijul
</p>
</li>
<li>
<p>
Git (only in eval time fetching using <span class="docutils literal">builtins.fetchGit</span>)
</p>
</li>
</ul>
<p>
Letâs show the way using the <a class="reference external" href="https://soupault.net"><cite>Soupault</cite></a> repository, but if itâs one of the supported kinds, any will work.
</p>
<p class="rubric">
Latest revision
</p>
<pre class="code kdl literal-block"><span class="c1">// manifest.kdl
</span><span class="nl">inputs</span><span class="w"> </span><span class="o">{</span><span class="nl">
</span><span class="nl"> soupault</span><span class="w"> </span><span class="o">{</span><span class="nl">
</span><span class="nl"> archive</span><span class="w"> </span><span class="o">{</span><span class="nl">
</span><span class="nl"> url</span><span class="w"> </span><span class="s">"https://codeberg.org/PataphysicalSociety/soupault/archive/{{fresh-value}}.tar.gz"</span><span class="w">
</span><span class="nl"> mirrors</span><span class="w"> </span><span class="s">"https://github.com/PataphysicalSociety/soupault/archive/{{fresh-value}}.tar.gz"</span><span class="w">
</span><span class="w"> </span><span class="o">}</span><span class="w">
</span><span class="w"> </span><span class="o">}</span><span class="w">
</span><span class="nl"> fresh-cmd</span><span class="w"> </span><span class="o">{</span><span class="nl">
</span><span class="nl"> $</span><span class="w"> </span><span class="s">git</span><span class="w"> </span><span class="s">ls-remote</span><span class="w"> </span><span class="s">--branches</span><span class="w"> </span><span class="s">main</span><span class="w"> </span><span class="s">"https://codeberg.org/PataphysicalSociety/soupault.git"</span><span class="w">
</span><span class="nl"> |</span><span class="w"> </span><span class="s">cut</span><span class="w"> </span><span class="s">-f1</span><span class="w">
</span><span class="w"> </span><span class="o">}</span><span class="w">
</span><span class="o">}</span></pre>
</section>
</section>
</article>
</main>
<footer id="Footer" class="Footer">
<p>
Site made with <a href="https://nixos.org">Nix</a> (<abbr title="dependency">dep</abbr> management), <a href="https://nickel-lang.org">Nickel</a> (<abbr title="configuration">config</abbr>), <a href="https://soupault.net">Soupault</a> (<abbr title="static site generator">SSG</abbr>), <a href="https://docutils.sourceforge.io">Docutils</a> (<abbr title="reStructuredText">rST</abbr> rendering), <a href="https://mandoc.bsd.lv">mandoc</a> (manpage conversion), & <a href="https://hub.darcs.net/toastal/sugilite256">sugilite256</a> (color scheme).
</p>
<small class="Footer-copyright">
© 2025â2026 <span itemtype="https://schema.org/Person" itemscope=""><a itemprop="url" href="https://toast.al"><span itemprop="name">toastal</span></a></span>.
© 2026 Nixtamal contributors.
Some rights reserved.
Except where otherwise noted, the content on this website is licensed under <abbr title="Creative Commons Attribution Share Alike 4.0 International">CC-BY-SA-4.0</abbr>.
Citations must attribute the workâs writer/maker & include a hyperlink to this website (or rather the work itself).
Yes, these rules/clauses apply to <abbr title="large language models">LLM</abbr>s & <abbr title="artificial intellegence">AI</abbr> assistants too.
</small>
<div id="Maker" itemscope="" itemtype="https://schema.org/Person">
<link itemprop="url" href="https://toast.al/">
<meta itemprop="name" content="toastal">
<meta itemprop="foundingDate" content="2025">
<link itemprop="logo" href="https://nixtamal.toast.al/asset/_hashed/nixtamal/image/nixtamal-logo-gmxzsw8388sf9paq05xws7an4hnl4nx0.svg">
<div itemprop="address" itemscope="" itemtype="https://schema.org/PostalAddress">
<meta itemprop="addressCountry" content="TH">
</div>
<link itemprop="sameAs" href="https://keybase.io/toastal">
<link itemprop="sameAs" href="https://liberapay.com/toastal/">
<link itemprop="sameAs" href="https://types.pl/@toastal">
<link itemprop="sameAs" href="https://hub.darcs.net/toastal">
<link itemprop="sameAs" href="https://smeder.ee/~toastal">
<link itemprop="sameAs" href="https://nest.pijul.com/toastal">
<link itemprop="sameAs" href="https://codeberg.org/toastal/">
<link itemprop="sameAs" href="https://git.sr.ht/~toastal/">
<link itemprop="sameAs" href="https://gitlab.com/toastal">
<link itemprop="sameAs" href="https://github.com/toastal">
</div>
</footer>
</div>
</body>
</html>
|
