ALPHA: wire is a tool to deploy nixos systems wire.althaea.zone/

more doc updates

+32 -6
+2 -3
doc/.vitepress/config.ts
··· 93 93 text: "Write a Hive", 94 94 link: "/guides/writing-a-hive", 95 95 }, 96 + { text: "Migrate to wire", link: "/guides/migrate" }, 96 97 { 97 - text: "With Flakes", 98 + text: "Use Flakes", 98 99 link: "/guides/flakes/overview", 99 100 items: [ 100 101 { ··· 103 104 }, 104 105 ], 105 106 }, 106 - { text: "Migrate to wire", link: "/guides/migrate" }, 107 107 { text: "Apply your Config", link: "/guides/apply" }, 108 - { text: "Use a non-root user", link: "/guides/non-root-user" }, 109 108 { text: "Target Nodes", link: "/guides/targeting" }, 110 109 { 111 110 text: "Features",
+1 -1
doc/guides/installation.md
··· 29 29 your hive from, sourced from the `stable` branch. 30 30 31 31 ::: code-group 32 - <<< @/snippets/guides/installation/flake.nix{38} [flake.nix] 32 + <<< @/snippets/guides/installation/flake.nix [flake.nix] 33 33 ::: 34 34 35 35 ## Installation through npins
+29 -2
doc/guides/migrate.md
··· 8 8 9 9 {{ $frontmatter.description }} 10 10 11 + Migrate from... 12 + 13 + - [Colmena](#from-colmena) 14 + - [`nixos-rebuild`](#from-nixos-rebuild) 15 + 11 16 ## From Colmena 12 17 18 + If you're familiar with colmena, wire will hopefully come quickly to you! (or, 19 + atleast that was the intention when writing it!). There are a few changes you 20 + should know: 21 + 22 + - Wire pushes a real binary file to apply keys. You'll need to _atleast_ add garnix's 23 + public key for your remote server otherwise it will refuse the binary. 24 + - [You don't have to use a root user](/guides/non-root-user.html) 25 + - `apply-local` does not exist, `apply` will apply locally when appropriate 26 + - [Many options have been aliased to nicer names](/reference/module.html) 27 + (ie, `deployment.targetUser` <=> `deployment.target.user`) 28 + - You may pass a list of hosts to `deployment.targetHost` (no more fiddling with 29 + your hive whenever DNS is down, for example) 30 + - `--path` optionally takes a flakeref! You can pass `--path github:foo/bar`, 31 + `--path git+file:///...`, `--path https://.../main.tar.gz`, etc. 32 + (plain paths like `--path ~/my-hive` still work as always) 33 + 13 34 ::: tip 14 35 You should also follow [installation](/guides/installation) to install the 15 36 binary. 16 37 ::: 17 38 18 - ### As a Flake 39 + ### Convert a Hive as a Flake 19 40 20 41 ```nix [flake.nix] 21 42 { ··· 35 56 } 36 57 ``` 37 58 38 - ### Non-flake 59 + ### Convert a Hive with npins 39 60 40 61 ::: tip 41 62 You should also follow [installation](/guides/installation) to setup ··· 61 82 62 83 Replacing `<nixpkgs>` with a pinned source is optional, but you should 63 84 probably use one if you ask me \:) 85 + 86 + ## From `nixos-rebuild` 87 + 88 + You can keep using `nixos-rebuild` alongside wire! 89 + 90 + Follow the instructions in [the relevant page](/guides/flakes/nixos-rebuild.html).