github fort-nix/nix-bitcoin v0.0.1
nix-bitcoin-0.0.1

latest releases: v0.0.107, v0.0.106, v0.0.105...
4 years ago

This is the first release of nix-bitcoin. It changes the way how nix-bitcoin is supposed to be used for deployments. The old way of keeping up with nix-bitcoin updates - merging upstream changes into the own deployment via git pull - is now deprecated. This means that nix-bitcoin is from now on updated through releases, which can be fetched with the fetch-release command in the nix-shell (see the update doc).

The main difference is that in order to deploy nix-bitcoin you are not supposed to fork and modify this repository anymore.
Instead, you have your own repository with a configuration.nix and import a release of nix-bitcoin. See the examples/ directory and in particular the shell.nix for how this works now and PR #136 for the actual changes that led to this release.

Migration guide

Note that since nix-bitcoin can be used in various ways. There's no single migration guide that can cover everything. This migration guide covers a installation on NixOS that is deployed with NixOps.
In particular, have a look at examples/shell.nix, the changes to installation instructions, as well as the new update process (PR #136).
If you have further questions I'm happy to assist in #nix-bitcoin on freenode.

  1. Update nix-bitcoin to latest commit before the release (b9fbb144cae9aa8c8d7ebe143ac02c3b1e15651d) and make sure your version of nix-bitcoin does not change existing files but configuration.nix.
  2. Create a new directory for you deployment
mkdir my-nix-bitcoin
mkdir my-nix-bitcoin/nixops
cp nix-bitcoin/{configuration.nix,hardware-configuration.nix} ./my-nix-bitcoin
cp nix-bitcoin/network/network-nixos.nix ./my-nix-bitcoin/nixops/node-nixos.nix
  1. Now pull nix-bitcoin, fetch the release, and copy the new nixops node file and shell.nix.
cd nix-bitcoin
git pull
cd examples
nix-shell
fetch-release > ../../my-nix-bitcoin/nix-bitcoin-release.nix
cp nixops/node.nix ../../my-nix-bitcoin/nixops/node.nix
cp shell.nix ../../my-nix-bitcoin/
  1. Go into your new deployment directory my-nix-bitcoin, open configuration.nix and replace ./modules/nix-bitcoin.nix with <nix-bitcoin/modules/nix-bitcoin.nix> in the imports array.
  2. Enter the nix-shell and modify your deployment to allow nixops to find your new deployment files
nix-shell
nixops modify -d bitcoin-node nixops/node.nix nixops/node-nixos.nix
  1. Run nixops deploy
  2. You can create a new git repo in my-nix-bitcoin (add secrets/ to .gitignore)

Don't miss a new nix-bitcoin release

NewReleases is sending notifications on new releases.