You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Nix packages and nixos modules for easily installing Bitcoin nodes and higher layer protocols with an emphasis on security.
7
-
This is a work in progress - don't expect it to be bugfreeor secure.
7
+
This is a work in progress - don't expect it to be bug-free, secure or stable.
8
8
9
9
The default configuration sets up a Bitcoin Core node and c-lightning. The user can enable spark-wallet in `configuration.nix` to make c-lightning accessible with a smartphone using spark-wallet.
10
10
A simple webpage shows the lightning nodeid and links to nanopos letting the user receive donations.
@@ -24,6 +24,30 @@ The goal is to make it easy to deploy a reasonably secure Bitcoin node with a us
24
24
It should allow managing bitcoin (the currency) effectively and providing public infrastructure.
25
25
It should be a reproducible and extensible platform for applications building on Bitcoin.
26
26
27
+
Example
28
+
---
29
+
The easiest way to try out nix-bitcoin is to use one of the provided examples.
30
+
31
+
```
32
+
git clone https://github.com/fort-nix/nix-bitcoin
33
+
cd examples/
34
+
nix-shell
35
+
```
36
+
37
+
The following example scripts set up a nix-bitcoin node according to `examples/configuration.nix` and then
38
+
shut down immediately. They leave no traces (outside of `/nix/store`) on the host system.
39
+
40
+
-`./deploy-container.sh` creates a [NixOS container](https://github.com/erikarvstedt/extra-container).\
41
+
This is the fastest way to set up a node.\
42
+
Requires: [NixOS](https://nixos.org/)
43
+
44
+
-`./deploy-qemu-vm.sh` creates a QEMU VM.\
45
+
Requires: [Nix](https://nixos.org/nix/)
46
+
47
+
-`./deploy-nixops.sh` creates a VirtualBox VM via [NixOps](https://github.com/NixOS/nixops).\
48
+
NixOps can be used to deploy to various other backends like cloud providers.\
@@ -48,8 +72,6 @@ The data directories of the services can be found in `/var/lib` on the deployed
48
72
49
73
Installation
50
74
---
51
-
The easiest way is to run `nix-shell` (on a Linux machine) in the nix-bitcoin directory and then create a [NixOps](https://nixos.org/nixops/manual/) deployment with the provided `network.nix` in the `network` directory.
52
-
Fix the FIXMEs in configuration.nix and deploy with nixops in nix-shell.
53
75
See [install.md](docs/install.md) for a detailed tutorial.
0 commit comments