@@ -20,34 +20,20 @@ as an input. Something like:
20
20
}
21
21
```
22
22
23
- This flake attempts to provide Holochain for its upcoming and stable releases. Currently, this would be the 0.4
24
- development versions and the stable 0.3 version .
23
+ This flake attempts to provide Holochain for its upcoming and stable releases. Currently, this would be the 0.5
24
+ development versions, the 0.4 stable versions and the 0.3 maintenance versions .
25
25
26
26
There isn't necessarily a migration path between minor versions of Holochain, so please refer to Holochain documentation
27
27
when upgrading. Just changing the version that you are consuming from this flake is unlikely to work.
28
28
29
- For Holochain 0.4 onwards, before you can get started, you will need a seed bundle for DPKI. You can use the CLI provided
30
- by this project to generate one. For example:
31
-
32
- ``` shell
33
- nix develop -c node ./seed-tool/index.js generate --out root.bundle
34
- # Provide a password
35
-
36
- nix develop -c node ./seed-tool/index.js derive --root root.bundle --out mymachine.bundle
37
- # Provide the password from step 1 again
38
- # Provide a password for this device bundle
39
- ````
40
-
41
- Keep the ` root.bundle` safe. It' s the device bundle that you will need to deploy.
42
-
43
29
The following is a very rough, sample flake. It will get you up and running, but you likely want to make improvements.
44
30
45
31
``` nix
46
32
{
47
33
inputs = {
48
34
nixpkgs.url = "github:nixos/nixpkgs?ref=nixos-24.11";
49
35
hc-nixos = {
50
- url = "github:ThetaSinner/hc-nixos?ref=rework ";
36
+ url = "github:ThetaSinner/hc-nixos?ref=main ";
51
37
inputs.nixpkgs.follows = "nixpkgs";
52
38
};
53
39
};
@@ -58,27 +44,22 @@ The following is a very rough, sample flake. It will get you up and running, but
58
44
modules = [
59
45
./configuration.nix
60
46
hc-nixos.nixosModules.hcCommon # Adds groups and users
61
- hc-nixos.nixosModules.lair-keystore-0_5 # Define the Lair service
47
+ hc-nixos.nixosModules.lair-keystore-for-0_4 # Define the Lair service
62
48
hc-nixos.nixosModules.conductor-0_4 # Define the Conductor service
63
49
({ pkgs, ... }: {
64
- environment.etc."lair-myMachine/device.bundle".text = "<contents of mymachine.bundle>";
65
-
66
- services.lair-keystore-0_5 = {
50
+ services.lair-keystore-for-0_4 = {
67
51
enable = true;
68
- id = "lair-05 ";
52
+ id = "lair";
69
53
package = hc-nixos.inputs.holonix-0_4.packages.x86_64-linux.lair-keystore;
70
54
passphrase = "pass"; # Secret, conductor must launch with the same phrase
71
- deviceSeed = "myMachine-seed"; # Not secret, just a name
72
- seedPassphrase = "<chosen in step 2 above>"; # Secret
73
55
};
74
56
75
57
services.conductor-0_4 = {
76
58
enable = true;
77
- id = "conductor-04 ";
78
- lairId = "lair-05 ";
59
+ id = "conductor";
60
+ lairId = "lair";
79
61
package = hc-nixos.inputs.holonix-0_4.packages.x86_64-linux.holochain;
80
62
keystorePassphrase = "pass"; # Secret, see Lair
81
- deviceSeed = "myMachine-seed"; # Not secret, see Lair
82
63
};
83
64
84
65
# Include the Holochain tools and sqlcipher which can be useful for debugging or fixing corrupted sqlite databases etc.
@@ -117,11 +98,11 @@ sudo nixos-rebuild switch
117
98
118
99
You are free to override the configuration, run with an embedded Lair keystore or even run multiple Holochain versions
119
100
side by side. I've started adding NixOS tests to demonstrate some different ways of running Holochain and showing how
120
- to configure it. You may use the tests under ` tests ` as a reference if you want some hints on how to do this.
101
+ to configure it. You may use the tests under ` tests ` as a reference if you want some hints about how to do this.
121
102
122
- Please note that the tests are not intended to be secure or production ready. They are just a way to demonstrate how
123
- to configure Holochain in different ways. It's left to you to ensure that your Holochain configuration is appropriate
124
- for your use case.
103
+ Please note that the tests are not intended to be secure or production ready. They are primarily for verification and
104
+ to demonstrate how to configure Holochain in different ways. It's left to you to ensure that your Holochain
105
+ configuration is appropriate for your use- case.
125
106
126
107
### Testing interactively with a VM
127
108
0 commit comments