qusal/salt/sys-electrs
Ben Grande f9ead06408 fix: remove extraneous package repository updates
Updates happens multiple times, normally 2 to 3, even if we consider a
state without includes. On states with multiple includes, it could
easily get approximately 10 updates being ran. This behavior leads to
unnecessary network bandwidth being spent and more time to run the
installation state. When the connection is slow and not using the
cacher, such as torified connections on Whonix, the installation can
occurs much faster.

Adding external repositories has to be done prior to update to ensure it
is also fetched.

Fixes: https://github.com/ben-grande/qusal/issues/29
2024-03-18 17:51:36 +01:00
..
files feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
clone.sls feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
clone.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
configure-builder-source.sls feat: bump electrs version 2024-03-15 17:12:14 +01:00
configure-builder-source.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
configure-builder.sls feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
configure-builder.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
configure-client.sls feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
configure-client.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
configure.sls feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
configure.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
create.sls fix: less menu items for bitcoin qubes 2024-02-18 17:08:30 +01:00
create.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
init.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
install-builder-source.sls fix: remove extraneous package repository updates 2024-03-18 17:51:36 +01:00
install-builder-source.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
install-builder.sls feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
install-builder.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
install-source.sls fix: remove extraneous package repository updates 2024-03-18 17:51:36 +01:00
install-source.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
install.sls feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
install.top feat: Bitcoin Core and Electrum servers and wallet 2024-02-17 00:07:33 +01:00
README.md feat: bump electrs version 2024-03-15 17:12:14 +01:00

sys-electrs

Electrs in Qubes OS.

Table of Contents

Description

Setup an offline Electrs (Electrum Server) qube named "sys-electrs", connected to your own full node running on "sys-bitcoin" to index the blockchain to allow for efficient query of the history of arbitrary addresses.

A disposable qube "disp-electrs-builder" will be created, it will serve to install and verify Electrs. After the verification succeeds, files are copied to the template "tpl-sys-electrs". This method was chosen so the server can be always offline.

At least 200GB of disk space is required.

Installation

This formula depends on sys-bitcoin.

  • Top
sudo qubesctl top.enable sys-electrs
sudo qubesctl --targets=tpl-electrs-builder,tpl-sys-electrs,disp-electrs-builder,sys-electrs state.apply
sudo qubesctl top.disable sys-electrs
  • State
sudo qubesctl state.apply sys-electrs.create
sudo qubesctl --skip-dom0 --targets=tpl-electrs-builder state.apply sys-electrs.install-builder
sudo qubesctl --skip-dom0 --targets=tpl-sys-electrs state.apply sys-electrs.install
sudo qubesctl --skip-dom0 --targets=disp-electrs-builder state.apply sys-electrs.configure-builder
sudo qubesctl --skip-dom0 --targets=sys-electrs state.apply sys-electrs.configure

Usage

You may customize Electrs by writing to the file ~/.electrs/conf.d/electrs.conf.local.

If you are not using sys-bitcoin, you will need to add the RPC Authentication cookie to the qube sys-electrs in the file ~/.bitcoin/.cookie. Make sure there is no new line at the end of the cookie file, else Electrs will fail to start.

Credits