ALPHA: wire is a tool to deploy nixos systems
wire.althaea.zone/
add install wire docs page
+427
-3
+39
-2
doc/guides/installation.md
+39
-2
doc/guides/installation.md
···
1
1
---
2
-
comment: false
2
+
comment: true
3
+
title: Install wire
4
+
description: How to install wire tool.
3
5
---
4
6
5
-
# Install Wire
7
+
# {{ $frontmatter.title }}
8
+
9
+
{{ $frontmatter.description }}
10
+
11
+
It is recommended you stick to versioned tags, the latest is `0.5.0`.
12
+
13
+
## Binary Cache
14
+
15
+
You should trust the substituter `https://wires.cachix.org` by
16
+
either editing `/etc/nix/nix.conf` or updating your NixOS configuration:
17
+
18
+
::: code-group
19
+
20
+
<<< @/snippets/getting-started/nix.conf
21
+
<<< @/snippets/getting-started/cache.nix [configuration.nix]
22
+
23
+
:::
24
+
25
+
## Installation through flakes
26
+
27
+
When using flakes, you should install wire through the same input you create
28
+
your hive from.
29
+
30
+
::: code-group
31
+
<<< @/snippets/guides/installation/flake.nix{38} [flake.nix]
32
+
:::
33
+
34
+
## Installation through npins
35
+
36
+
```sh
37
+
$ npins add github wires-org wire --at v0.5.0
38
+
```
39
+
40
+
::: code-group
41
+
<<< @/snippets/guides/installation/shell.nix{8} [shell.nix]
42
+
:::
+344
doc/snippets/guides/installation/flake.lock
+344
doc/snippets/guides/installation/flake.lock
···
1
+
{
2
+
"nodes": {
3
+
"crane": {
4
+
"locked": {
5
+
"lastModified": 1759893430,
6
+
"narHash": "sha256-yAy4otLYm9iZ+NtQwTMEbqHwswSFUbhn7x826RR6djw=",
7
+
"owner": "ipetkov",
8
+
"repo": "crane",
9
+
"rev": "1979a2524cb8c801520bd94c38bb3d5692419d93",
10
+
"type": "github"
11
+
},
12
+
"original": {
13
+
"owner": "ipetkov",
14
+
"repo": "crane",
15
+
"type": "github"
16
+
}
17
+
},
18
+
"fenix": {
19
+
"inputs": {
20
+
"nixpkgs": [
21
+
"wire",
22
+
"nixpkgs"
23
+
],
24
+
"rust-analyzer-src": "rust-analyzer-src"
25
+
},
26
+
"locked": {
27
+
"lastModified": 1760424233,
28
+
"narHash": "sha256-8jLfVik1ccwmacVW5BlprmsuK534rT5HjdPhkSaew44=",
29
+
"owner": "nix-community",
30
+
"repo": "fenix",
31
+
"rev": "48a763cdc0b2d07199a021de99c2ca50af76e49f",
32
+
"type": "github"
33
+
},
34
+
"original": {
35
+
"owner": "nix-community",
36
+
"repo": "fenix",
37
+
"type": "github"
38
+
}
39
+
},
40
+
"flake-compat": {
41
+
"locked": {
42
+
"lastModified": 1747046372,
43
+
"narHash": "sha256-CIVLLkVgvHYbgI2UpXvIIBJ12HWgX+fjA8Xf8PUmqCY=",
44
+
"owner": "edolstra",
45
+
"repo": "flake-compat",
46
+
"rev": "9100a0f413b0c601e0533d1d94ffd501ce2e7885",
47
+
"type": "github"
48
+
},
49
+
"original": {
50
+
"owner": "edolstra",
51
+
"repo": "flake-compat",
52
+
"type": "github"
53
+
}
54
+
},
55
+
"flake-compat_2": {
56
+
"flake": false,
57
+
"locked": {
58
+
"lastModified": 1747046372,
59
+
"narHash": "sha256-CIVLLkVgvHYbgI2UpXvIIBJ12HWgX+fjA8Xf8PUmqCY=",
60
+
"owner": "edolstra",
61
+
"repo": "flake-compat",
62
+
"rev": "9100a0f413b0c601e0533d1d94ffd501ce2e7885",
63
+
"type": "github"
64
+
},
65
+
"original": {
66
+
"owner": "edolstra",
67
+
"repo": "flake-compat",
68
+
"type": "github"
69
+
}
70
+
},
71
+
"flake-parts": {
72
+
"inputs": {
73
+
"nixpkgs-lib": "nixpkgs-lib"
74
+
},
75
+
"locked": {
76
+
"lastModified": 1759362264,
77
+
"narHash": "sha256-wfG0S7pltlYyZTM+qqlhJ7GMw2fTF4mLKCIVhLii/4M=",
78
+
"owner": "hercules-ci",
79
+
"repo": "flake-parts",
80
+
"rev": "758cf7296bee11f1706a574c77d072b8a7baa881",
81
+
"type": "github"
82
+
},
83
+
"original": {
84
+
"owner": "hercules-ci",
85
+
"repo": "flake-parts",
86
+
"type": "github"
87
+
}
88
+
},
89
+
"git-hooks": {
90
+
"inputs": {
91
+
"flake-compat": "flake-compat_2",
92
+
"gitignore": "gitignore",
93
+
"nixpkgs": "nixpkgs_2"
94
+
},
95
+
"locked": {
96
+
"lastModified": 1760392170,
97
+
"narHash": "sha256-WftxJgr2MeDDFK47fQKywzC72L2jRc/PWcyGdjaDzkw=",
98
+
"owner": "cachix",
99
+
"repo": "git-hooks.nix",
100
+
"rev": "46d55f0aeb1d567a78223e69729734f3dca25a85",
101
+
"type": "github"
102
+
},
103
+
"original": {
104
+
"owner": "cachix",
105
+
"repo": "git-hooks.nix",
106
+
"type": "github"
107
+
}
108
+
},
109
+
"gitignore": {
110
+
"inputs": {
111
+
"nixpkgs": [
112
+
"wire",
113
+
"git-hooks",
114
+
"nixpkgs"
115
+
]
116
+
},
117
+
"locked": {
118
+
"lastModified": 1709087332,
119
+
"narHash": "sha256-HG2cCnktfHsKV0s4XW83gU3F57gaTljL9KNSuG6bnQs=",
120
+
"owner": "hercules-ci",
121
+
"repo": "gitignore.nix",
122
+
"rev": "637db329424fd7e46cf4185293b9cc8c88c95394",
123
+
"type": "github"
124
+
},
125
+
"original": {
126
+
"owner": "hercules-ci",
127
+
"repo": "gitignore.nix",
128
+
"type": "github"
129
+
}
130
+
},
131
+
"linux-systems": {
132
+
"locked": {
133
+
"lastModified": 1689347949,
134
+
"narHash": "sha256-12tWmuL2zgBgZkdoB6qXZsgJEH9LR3oUgpaQq2RbI80=",
135
+
"owner": "nix-systems",
136
+
"repo": "default-linux",
137
+
"rev": "31732fcf5e8fea42e59c2488ad31a0e651500f68",
138
+
"type": "github"
139
+
},
140
+
"original": {
141
+
"owner": "nix-systems",
142
+
"repo": "default-linux",
143
+
"type": "github"
144
+
}
145
+
},
146
+
"nixpkgs": {
147
+
"locked": {
148
+
"lastModified": 1760524057,
149
+
"narHash": "sha256-EVAqOteLBFmd7pKkb0+FIUyzTF61VKi7YmvP1tw4nEw=",
150
+
"owner": "NixOS",
151
+
"repo": "nixpkgs",
152
+
"rev": "544961dfcce86422ba200ed9a0b00dd4b1486ec5",
153
+
"type": "github"
154
+
},
155
+
"original": {
156
+
"owner": "NixOS",
157
+
"ref": "nixos-unstable",
158
+
"repo": "nixpkgs",
159
+
"type": "github"
160
+
}
161
+
},
162
+
"nixpkgs-lib": {
163
+
"locked": {
164
+
"lastModified": 1754788789,
165
+
"narHash": "sha256-x2rJ+Ovzq0sCMpgfgGaaqgBSwY+LST+WbZ6TytnT9Rk=",
166
+
"owner": "nix-community",
167
+
"repo": "nixpkgs.lib",
168
+
"rev": "a73b9c743612e4244d865a2fdee11865283c04e6",
169
+
"type": "github"
170
+
},
171
+
"original": {
172
+
"owner": "nix-community",
173
+
"repo": "nixpkgs.lib",
174
+
"type": "github"
175
+
}
176
+
},
177
+
"nixpkgs_2": {
178
+
"locked": {
179
+
"lastModified": 1759070547,
180
+
"narHash": "sha256-JVZl8NaVRYb0+381nl7LvPE+A774/dRpif01FKLrYFQ=",
181
+
"owner": "NixOS",
182
+
"repo": "nixpkgs",
183
+
"rev": "647e5c14cbd5067f44ac86b74f014962df460840",
184
+
"type": "github"
185
+
},
186
+
"original": {
187
+
"owner": "NixOS",
188
+
"ref": "nixpkgs-unstable",
189
+
"repo": "nixpkgs",
190
+
"type": "github"
191
+
}
192
+
},
193
+
"nixpkgs_3": {
194
+
"locked": {
195
+
"lastModified": 1760284886,
196
+
"narHash": "sha256-TK9Kr0BYBQ/1P5kAsnNQhmWWKgmZXwUQr4ZMjCzWf2c=",
197
+
"owner": "NixOS",
198
+
"repo": "nixpkgs",
199
+
"rev": "cf3f5c4def3c7b5f1fc012b3d839575dbe552d43",
200
+
"type": "github"
201
+
},
202
+
"original": {
203
+
"owner": "NixOS",
204
+
"ref": "nixos-unstable",
205
+
"repo": "nixpkgs",
206
+
"type": "github"
207
+
}
208
+
},
209
+
"nixpkgs_4": {
210
+
"locked": {
211
+
"lastModified": 1754340878,
212
+
"narHash": "sha256-lgmUyVQL9tSnvvIvBp7x1euhkkCho7n3TMzgjdvgPoU=",
213
+
"owner": "nixos",
214
+
"repo": "nixpkgs",
215
+
"rev": "cab778239e705082fe97bb4990e0d24c50924c04",
216
+
"type": "github"
217
+
},
218
+
"original": {
219
+
"owner": "nixos",
220
+
"ref": "nixpkgs-unstable",
221
+
"repo": "nixpkgs",
222
+
"type": "github"
223
+
}
224
+
},
225
+
"nixpkgs_current_stable": {
226
+
"locked": {
227
+
"lastModified": 1760139962,
228
+
"narHash": "sha256-4xggC56Rub3WInz5eD7EZWXuLXpNvJiUPahGtMkwtuc=",
229
+
"owner": "NixOS",
230
+
"repo": "nixpkgs",
231
+
"rev": "7e297ddff44a3cc93673bb38d0374df8d0ad73e4",
232
+
"type": "github"
233
+
},
234
+
"original": {
235
+
"owner": "NixOS",
236
+
"ref": "nixos-25.05",
237
+
"repo": "nixpkgs",
238
+
"type": "github"
239
+
}
240
+
},
241
+
"root": {
242
+
"inputs": {
243
+
"nixpkgs": "nixpkgs",
244
+
"systems": "systems",
245
+
"wire": "wire"
246
+
}
247
+
},
248
+
"rust-analyzer-src": {
249
+
"flake": false,
250
+
"locked": {
251
+
"lastModified": 1760260966,
252
+
"narHash": "sha256-pOVvZz/aa+laeaUKyE6PtBevdo4rywMwjhWdSZE/O1c=",
253
+
"owner": "rust-lang",
254
+
"repo": "rust-analyzer",
255
+
"rev": "c5181dbbe33af6f21b9d83e02fdb6fda298a3b65",
256
+
"type": "github"
257
+
},
258
+
"original": {
259
+
"owner": "rust-lang",
260
+
"ref": "nightly",
261
+
"repo": "rust-analyzer",
262
+
"type": "github"
263
+
}
264
+
},
265
+
"systems": {
266
+
"locked": {
267
+
"lastModified": 1681028828,
268
+
"narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",
269
+
"owner": "nix-systems",
270
+
"repo": "default",
271
+
"rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",
272
+
"type": "github"
273
+
},
274
+
"original": {
275
+
"owner": "nix-systems",
276
+
"repo": "default",
277
+
"type": "github"
278
+
}
279
+
},
280
+
"systems_2": {
281
+
"locked": {
282
+
"lastModified": 1681028828,
283
+
"narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",
284
+
"owner": "nix-systems",
285
+
"repo": "default",
286
+
"rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",
287
+
"type": "github"
288
+
},
289
+
"original": {
290
+
"owner": "nix-systems",
291
+
"repo": "default",
292
+
"type": "github"
293
+
}
294
+
},
295
+
"treefmt-nix": {
296
+
"inputs": {
297
+
"nixpkgs": "nixpkgs_4"
298
+
},
299
+
"locked": {
300
+
"lastModified": 1760120816,
301
+
"narHash": "sha256-gq9rdocpmRZCwLS5vsHozwB6b5nrOBDNc2kkEaTXHfg=",
302
+
"owner": "numtide",
303
+
"repo": "treefmt-nix",
304
+
"rev": "761ae7aff00907b607125b2f57338b74177697ed",
305
+
"type": "github"
306
+
},
307
+
"original": {
308
+
"owner": "numtide",
309
+
"repo": "treefmt-nix",
310
+
"type": "github"
311
+
}
312
+
},
313
+
"wire": {
314
+
"inputs": {
315
+
"crane": "crane",
316
+
"fenix": "fenix",
317
+
"flake-compat": "flake-compat",
318
+
"flake-parts": "flake-parts",
319
+
"git-hooks": "git-hooks",
320
+
"linux-systems": "linux-systems",
321
+
"nixpkgs": "nixpkgs_3",
322
+
"nixpkgs_current_stable": "nixpkgs_current_stable",
323
+
"systems": "systems_2",
324
+
"treefmt-nix": "treefmt-nix"
325
+
},
326
+
"locked": {
327
+
"lastModified": 1758104393,
328
+
"narHash": "sha256-ddXhp8hDFMKUiVf+V5Q71Ehfw8o1kGofxN9cAljyfOI=",
329
+
"owner": "wires-org",
330
+
"repo": "wire",
331
+
"rev": "6c99f40273aa16dc6603375dc2c867b9265a289a",
332
+
"type": "github"
333
+
},
334
+
"original": {
335
+
"owner": "wires-org",
336
+
"ref": "v0.5.0",
337
+
"repo": "wire",
338
+
"type": "github"
339
+
}
340
+
}
341
+
},
342
+
"root": "root",
343
+
"version": 7
344
+
}
+32
doc/snippets/guides/installation/flake.nix
+32
doc/snippets/guides/installation/flake.nix
···
1
+
{
2
+
inputs = {
3
+
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
4
+
wire.url = "github:wires-org/wire/v0.5.0";
5
+
systems.url = "github:nix-systems/default";
6
+
};
7
+
8
+
outputs = inputs @ {
9
+
nixpkgs,
10
+
wire,
11
+
systems,
12
+
...
13
+
}: let
14
+
forAllSystems = nixpkgs.lib.genAttrs (import systems);
15
+
in {
16
+
wire = wire.makeHive {
17
+
# ...
18
+
};
19
+
20
+
devShells = forAllSystems (
21
+
system: let
22
+
pkgs = nixpkgs.legacyPackages.${system};
23
+
in {
24
+
default = pkgs.mkShell {
25
+
buildInputs = [
26
+
wire.packages.${system}.wire
27
+
];
28
+
};
29
+
}
30
+
);
31
+
};
32
+
}
+11
doc/snippets/guides/installation/shell.nix
+11
doc/snippets/guides/installation/shell.nix
+1
-1
doc/tutorial/part-one/nix-setup.md
+1
-1
doc/tutorial/part-one/nix-setup.md
···
10
10
11
11
::: warning
12
12
This page is for the purposes for the **Tutorial**.
13
-
You should read [Guides - Installation](/guides/installation.html) for installing Wire for
13
+
You should read [How-to Guides - Install wire](/guides/installation.html) for installing Wire for
14
14
regular use.
15
15
:::
16
16