pyrox.dev
1<chapter xmlns="http://docbook.org/ns/docbook"
2 xmlns:xlink="http://www.w3.org/1999/xlink"
3 xmlns:xi="http://www.w3.org/2001/XInclude"
4 version="5.0"
5 xml:id="module-programs-digitalbitbox">
6 <title>Digital Bitbox</title>
7 <para>
8 Digital Bitbox is a hardware wallet and second-factor authenticator.
9 </para>
10 <para>
11 The <literal>digitalbitbox</literal> programs module may be installed by
12 setting <literal>programs.digitalbitbox</literal> to <literal>true</literal>
13 in a manner similar to
14<programlisting>
15<xref linkend="opt-programs.digitalbitbox.enable"/> = true;
16</programlisting>
17 and bundles the <literal>digitalbitbox</literal> package (see
18 <xref
19 linkend="sec-digitalbitbox-package" />), which contains the
20 <literal>dbb-app</literal> and <literal>dbb-cli</literal> binaries, along
21 with the hardware module (see
22 <xref
23 linkend="sec-digitalbitbox-hardware-module" />) which sets up the
24 necessary udev rules to access the device.
25 </para>
26 <para>
27 Enabling the digitalbitbox module is pretty much the easiest way to get a
28 Digital Bitbox device working on your system.
29 </para>
30 <para>
31 For more information, see
32 <link xlink:href="https://digitalbitbox.com/start_linux" />.
33 </para>
34 <section xml:id="sec-digitalbitbox-package">
35 <title>Package</title>
36
37 <para>
38 The binaries, <literal>dbb-app</literal> (a GUI tool) and
39 <literal>dbb-cli</literal> (a CLI tool), are available through the
40 <literal>digitalbitbox</literal> package which could be installed as
41 follows:
42<programlisting>
43<xref linkend="opt-environment.systemPackages"/> = [
44 pkgs.digitalbitbox
45];
46</programlisting>
47 </para>
48 </section>
49 <section xml:id="sec-digitalbitbox-hardware-module">
50 <title>Hardware</title>
51
52 <para>
53 The digitalbitbox hardware package enables the udev rules for Digital Bitbox
54 devices and may be installed as follows:
55<programlisting>
56<xref linkend="opt-hardware.digitalbitbox.enable"/> = true;
57</programlisting>
58 </para>
59
60 <para>
61 In order to alter the udev rules, one may provide different values for the
62 <literal>udevRule51</literal> and <literal>udevRule52</literal> attributes
63 by means of overriding as follows:
64<programlisting>
65programs.digitalbitbox = {
66 <link linkend="opt-programs.digitalbitbox.enable">enable</link> = true;
67 <link linkend="opt-programs.digitalbitbox.package">package</link> = pkgs.digitalbitbox.override {
68 udevRule51 = "something else";
69 };
70};
71</programlisting>
72 </para>
73 </section>
74</chapter>