e41ca3b347
* digitalbitbox: init at 2.2.2 The commits that lead to this have been squashed from independent commits see branch @vidbina/add/digitalbitbox-wip that did the following: - 0a3030fa0ec digitalbitbox: init at 2.2.2 - c18ffa3ffd4 digitalbitbox: moved meta to EOF - 0c5f3d6972a digitalbitbox: using preConfigure + configureFlags - a85b1dfc3fd digitalbitbox: nativeBuildInputs - 90bdd35ef0f digitalbitbox: autoreconfHook - 91810eea055 digitalbitbox: default installPhase & makeWrapper - 90e43fb7e2a digitalbitbox: doc rm $PWD hack & printf-tee deal - fd033b2fe5a digitalbitbox: cleanup, alphabetically sort attrs - c5907982db3 digitalbitbox: added hardware module - 88e46bc9ae0 digitalbitbox: added program module - amend to change name: dbb-app -> digitalbitbox - amend to add install instructions based on feedback (https://github.com/NixOS/nixpkgs/pull/33787#issuecomment-362813149) - amend to add longDescription - moved program to its own dir - overridable udev rules handling - added docs to manual - added package attr to program module - added package attr to hardware module * digitalbitbox: use libsForQt5.callPackage
85 lines
2.5 KiB
XML
85 lines
2.5 KiB
XML
<chapter xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
version="5.0"
|
|
xml:id="module-programs-digitalbitbox">
|
|
|
|
<title>Digital Bitbox</title>
|
|
|
|
<para>
|
|
Digital Bitbox is a hardware wallet and second-factor authenticator.
|
|
</para>
|
|
|
|
<para>
|
|
The <literal>digitalbitbox</literal> programs module may be
|
|
installed by setting <literal>programs.digitalbitbox</literal>
|
|
to <literal>true</literal> in a manner similar to
|
|
|
|
<programlisting>
|
|
programs.digitalbitbox.enable = true;
|
|
</programlisting>
|
|
|
|
and bundles the <literal>digitalbitbox</literal> package (see <xref
|
|
linkend="sec-digitalbitbox-package" />), which contains the
|
|
<literal>dbb-app</literal> and <literal>dbb-cli</literal> binaries,
|
|
along with the hardware module (see <xref
|
|
linkend="sec-digitalbitbox-hardware-module" />) which sets up the
|
|
necessary udev rules to access the device.
|
|
</para>
|
|
|
|
<para>
|
|
Enabling the digitalbitbox module is pretty much the easiest way to
|
|
get a Digital Bitbox device working on your system.
|
|
</para>
|
|
|
|
<para>
|
|
For more information, see
|
|
<link xlink:href="https://digitalbitbox.com/start_linux" />.
|
|
</para>
|
|
|
|
<section xml:id="sec-digitalbitbox-package">
|
|
<title>Package</title>
|
|
|
|
<para>
|
|
The binaries, <literal>dbb-app</literal> (a GUI tool) and
|
|
<literal>dbb-cli</literal> (a CLI tool), are available through the
|
|
<literal>digitalbitbox</literal> package which could be installed
|
|
as follows:
|
|
|
|
<programlisting>
|
|
environment.systemPackages = [
|
|
pkgs.digitalbitbox
|
|
];
|
|
</programlisting>
|
|
</para>
|
|
</section>
|
|
|
|
|
|
<section xml:id="sec-digitalbitbox-hardware-module">
|
|
<title>Hardware</title>
|
|
|
|
<para>
|
|
The digitalbitbox hardware package enables the udev rules for
|
|
Digital Bitbox devices and may be installed as follows:
|
|
|
|
<programlisting>
|
|
hardware.digitalbitbox.enable = true;
|
|
</programlisting>
|
|
</para>
|
|
|
|
<para>
|
|
In order to alter the udev rules, one may provide different values for
|
|
the <literal>udevRule51</literal> and <literal>udevRule52</literal>
|
|
attributes by means of overriding as follows:
|
|
|
|
<programlisting>
|
|
programs.digitalbitbox = {
|
|
enable = true;
|
|
package = pkgs.digitalbitbox.override {
|
|
udevRule51 = "something else";
|
|
};
|
|
};
|
|
</programlisting>
|
|
</para>
|
|
</section>
|
|
</chapter>
|