summary refs log tree commit diff
path: root/nixos/doc
diff options
context:
space:
mode:
authorMarek Mahut <marek.mahut@gmail.com>2020-08-03 15:56:56 +0200
committerGitHub <noreply@github.com>2020-08-03 15:56:56 +0200
commit4181ae25bffd50169b3c2ff951db3b7f84afa8c0 (patch)
tree9db59ecd7709c8f3e1630017cea273fe8b269203 /nixos/doc
parentb6c3c725c61f297744cdb8609d87e9e49969bd5e (diff)
parent89b9c3ab9201b3a9adf3627b3546f1d9c805c70c (diff)
downloadnixpkgs-4181ae25bffd50169b3c2ff951db3b7f84afa8c0.tar
nixpkgs-4181ae25bffd50169b3c2ff951db3b7f84afa8c0.tar.gz
nixpkgs-4181ae25bffd50169b3c2ff951db3b7f84afa8c0.tar.bz2
nixpkgs-4181ae25bffd50169b3c2ff951db3b7f84afa8c0.tar.lz
nixpkgs-4181ae25bffd50169b3c2ff951db3b7f84afa8c0.tar.xz
nixpkgs-4181ae25bffd50169b3c2ff951db3b7f84afa8c0.tar.zst
nixpkgs-4181ae25bffd50169b3c2ff951db3b7f84afa8c0.zip
Merge pull request #94166 from 1000101/bitcoind
release-notes/rl-2009: amend bitcoind incompatibility
Diffstat (limited to 'nixos/doc')
-rw-r--r--nixos/doc/manual/release-notes/rl-2009.xml39
1 files changed, 30 insertions, 9 deletions
diff --git a/nixos/doc/manual/release-notes/rl-2009.xml b/nixos/doc/manual/release-notes/rl-2009.xml
index e03a5f5ce5c..2225619d481 100644
--- a/nixos/doc/manual/release-notes/rl-2009.xml
+++ b/nixos/doc/manual/release-notes/rl-2009.xml
@@ -544,21 +544,42 @@ systemd.services.nginx.serviceConfig.ReadWritePaths = [ "/var/www" ];
      to be used for every display-manager in NixOS.
     </para>
    </listitem>
-  <listitem>
+   <listitem>
     <para>
      The <literal>bitcoind</literal> module has changed to multi-instance, using submodules.
-     Therefore, it is now mandatory to name each instance, e.g.:
+     Therefore, it is now mandatory to name each instance.
+     To use this new multi-instance config with an existing bitcoind data directory and user, 
+     you have to adjust the original config, e.g.:
 <programlisting>
-services.bitcoind = {
-  enable = true;
-};
+  services.bitcoind = {
+    enable = true;
+    extraConfig = "...";
+    ...
+  };
 </programlisting>
-     requires a name now:
+     To something similar:
 <programlisting>
-services.bitcoind."example-mainnet" = {
-  enable = true;
-};
+  services.bitcoind.mainnet = {
+    enable = true;
+    dataDir = "/var/lib/bitcoind";
+    user = "bitcoin";
+    extraConfig = "...";
+    ...
+  };
 </programlisting>
+     The key settings are:
+     <itemizedlist>
+      <listitem>
+       <para>
+        <literal>dataDir</literal> - to continue using the same data directory.
+       </para>
+      </listitem>
+      <listitem>
+       <para>
+        <literal>user</literal> - to continue using the same user so that bitcoind maintains access to its files.
+       </para>
+      </listitem>
+     </itemizedlist>
     </para>
    </listitem>
    <listitem>