> For the complete documentation index, see [llms.txt](https://minibolt.minibolt.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://minibolt.minibolt.info/bonus-guides/bitcoin/electrs.md).

# Electrs

[Electrs](https://github.com/romanz/electrs/) is an efficient re-implementation of Electrum Server in Rust, inspired by [ElectrumX](https://github.com/kyuupichan/electrumx), [Electrum Personal Server](https://github.com/chris-belcher/electrum-personal-server), and [bitcoincore-indexd](https://github.com/jonasschnelli/bitcoincore-indexd).

{% hint style="warning" %}
Difficulty: Medium
{% endhint %}

![](/files/QjIQjcLOhdglRCv9BKGi)

## Requirements

* Bitcoin client: [Bitcoin Core](/bitcoin/bitcoin/bitcoin-core.md) or [Bitcoin Knots](/bonus-guides/bitcoin/bitcoin-knots.md)
* Others
  * [Rustup + Cargo](/bonus-guides/system/rustup-cargo.md)

## Preparations

-> Make sure that you have followed the [Activate mempool & reduce 'dbcache' after a full sync](/bitcoin/bitcoin/bitcoin-core.md#activate-mempool-and-reduce-dbcache-after-a-full-sync) section.

### Install dependencies

* With user `admin`, update the packages and upgrade to keep up to date with the OS

```sh
sudo apt update && sudo apt full-upgrade
```

* Make sure that all necessary software packages are installed

{% code overflow="wrap" %}

```sh
sudo apt install libgflags-dev libsnappy-dev zlib1g-dev libbz2-dev liblz4-dev libzstd-dev clang llvm-dev libclang-dev make g++ cmake build-essential
```

{% endcode %}

* Install the `librocksdb v7.8.3` from the source code. Go to the temporary folder

```bash
cd /tmp
```

* Clone the [rocksdb](https://github.com/facebook/rocksdb) GitHub repository and enter the `rocksdb` folder

```bash
git clone -b v9.10.0 --depth 1 https://github.com/facebook/rocksdb && cd rocksdb
```

* Compile it

```bash
make shared_lib -j $(nproc)
```

<details>

<summary>Expected output ⬇️</summary>

```
$DEBUG_LEVEL is 0
$DEBUG_LEVEL is 0
  CC       cache/cache.o
  CC       cache/cache_entry_roles.o
  CC       cache/cache_key.o
  CC       cache/cache_reservation_manager.o
  CC       cache/charged_cache.o
  CC       cache/clock_cache.o
  CC       cache/fast_lru_cache.o
  CC       cache/lru_cache.o
  CC       cache/compressed_secondary_cache.o
  CC       cache/sharded_cache.o
  CC       db/arena_wrapped_db_iter.o
  CC       db/blob/blob_contents.o
  CC       db/blob/blob_fetcher.o
  CC       db/blob/blob_file_addition.o
  CC       db/blob/blob_file_builder.o
  CC       db/blob/blob_file_cache.o
  CC       db/blob/blob_file_garbage.o
  [...]
```

</details>

{% hint style="info" %}
This process can take several minutes, 10-15 minutes, or more, depending on the performance of your device. Please be patient until the prompt shows again
{% endhint %}

* Install it

```bash
sudo make install-shared
```

<details>

<summary>Expected output ⬇️</summary>

```
$DEBUG_LEVEL is 0
echo 'prefix=/usr/local' > rocksdb.pc
echo 'exec_prefix=${prefix}' >> rocksdb.pc
echo 'includedir=${prefix}/include' >> rocksdb.pc
echo 'libdir=/usr/local/lib' >> rocksdb.pc
echo '' >> rocksdb.pc
echo 'Name: rocksdb' >> rocksdb.pc
echo 'Description: An embeddable persistent key-value store for fast storage' >> rocksdb.pc
echo Version: 7.8.3 >> rocksdb.pc
echo 'Libs: -L${libdir}  -ldl -Wl,-rpath -Wl,'$ORIGIN' -lrocksdb' >> rocksdb.pc
echo 'Libs.private: -lpthread -lrt -ldl -lsnappy -lgflags -lz -lbz2 -llz4 -lzstd ' >> rocksdb.pc
echo 'Cflags: -I${includedir} -std=c++17  -faligned-new -DHAVE_ALIGNED_NEW -DROCKSDB_PLATFORM_POSIX -DROCKSDB_LIB_IO_POSIX  -DOS_LINUX -fno-builtin-memcmp -DROCKSDB_FALLOCATE_PRESENT -DSNAPPY -DGFLAGS=1 -DZLIB -DBZIP2 -DLZ4 -DZSTD -DROCKSDB_MALLOC_USABLE_SIZE -DROCKSDB_PTHREAD_ADAPTIVE_MUTEX -DROCKSDB_BACKTRACE -DROCKSDB_RANGESYNC_PRESENT -DROCKSDB_SCHED_GETCPU_PRESENT -DROCKSDB_AUXV_GETAUXVAL_PRESENT -DHAVE_UINT128_EXTENSION  -isystem third-party/gtest-1.8.1/fused-src' >> rocksdb.pc
echo 'Requires: ' >> rocksdb.pc
install -d /usr/local/lib
install -d /usr/local/lib/pkgconfig
for header_dir in `find "include/rocksdb" -type d`; do \
        install -d //usr/local/$header_dir; \
done
for header in `find "include/rocksdb" -type f -name *.h`; do \
        install -C -m 644 $header //usr/local/$header; \
done
for header in ; do \
        install -d //usr/local/include/rocksdb/`dirname $header`; \
        install -C -m 644 $header //usr/local/include/rocksdb/$header; \
done
install -C -m 644 rocksdb.pc /usr/local/lib/pkgconfig/rocksdb.pc
install -d /usr/local/lib
install -C -m 755 librocksdb.so.7.8.3 /usr/local/lib
ln -fs librocksdb.so.7.8.3 /usr/local/lib/librocksdb.so.7.8
ln -fs librocksdb.so.7.8.3 /usr/local/lib/librocksdb.so.7
ln -fs librocksdb.so.7.8.3 /usr/local/lib/librocksdb.so
```

</details>

* Update the shared library cache. Wait until the prompt comes back to show

```bash
sudo ldconfig
```

* Come back to the `/tmp` folder

```bash
cd ..
```

* Delete `rocksdb` folder

```bash
sudo rm -r rocksdb
```

#### Install Rustc (Cargo included)

* Check if you already have `Rustc` installed

```bash
rustc --version
```

Expected output:

```
rustc 1.71.0 (8ede3aae2 2023-07-12)
```

* And cargo installed

```bash
cargo -V
```

Expected output:

```
cargo 1.71.0 (cfd3bbd8f 2023-06-08)
```

{% hint style="warning" %}
If you obtain "**command not found**" outputs, you need to follow the [Rustup + Cargo bonus section](/bonus-guides/system/rustup-cargo.md) to install it, and then come back to continue with the guide
{% endhint %}

### Reverse proxy & Firewall

In the [Security section](/system/system/security.md), we already set up Nginx as a reverse proxy. Now we can add the Electrs configuration.

* With user `admin`, create the reverse proxy configuration

```sh
sudo nano /etc/nginx/streams-available/electrs-reverse-proxy.conf
```

* Paste the following complete configuration. Save and exit

```nginx
upstream electrs {
  server 127.0.0.1:50021;
}
server {
  listen 50022 ssl;
  proxy_pass electrs;
}
```

* Create the symbolic link that points to the directory `streams-enabled`

{% code overflow="wrap" %}

```bash
sudo ln -s /etc/nginx/streams-available/electrs-reverse-proxy.conf /etc/nginx/streams-enabled/
```

{% endcode %}

* Test the Nginx configuration

```bash
sudo nginx -t
```

Expected output:

```
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
```

* Reload the Nginx configuration to apply changes

```sh
sudo systemctl reload nginx
```

* Configure the firewall to allow incoming requests to the SSL and TCP ports

```sh
sudo ufw allow 50022/tcp comment 'allow Electrs SSL from anywhere'
```

```sh
sudo ufw allow 50021/tcp comment 'allow Electrs TCP from anywhere'
```

## Installation

There are no precompiled binaries available for Electrs, so we should compile the application ourselves.

### Build from the source code

* With user `admin`, go to the temporary folder

```sh
cd /tmp
```

* Set a temporary version of the environment variable for the installation

```sh
VERSION=0.11.1
```

* Download the source code and go to the `electrs` folder

```sh
git clone --branch v$VERSION https://github.com/romanz/electrs.git && cd electrs
```

* To avoid using bad source code, verify that the main developer, Roman Zeyde, has properly signed the release. Create the `git` folder inside the `.config` folder in the `admin` home

```shellscript
mkdir /home/admin/.config/git
```

* Create the `allowed_signers` file

```bash
nano /home/admin/.config/git/allowed_signers
```

* Enter the next content. Save and exit

```
git@romanzey.de ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAZVq/3fgkildjN/MqEnhrP5550sDpFzGxMwevr5q/9w
```

* Tell Git about this file

```bash
git config --global gpg.ssh.allowedSignersFile ~/.config/git/allowed_signers
```

* Verify the release

```shellscript
git verify-tag -v v$VERSION
```

**Example** of expected output:

<pre><code>object 35216c6d30148be8e6763d913d437330f431fc03
type commit
tag v0.11.1
tagger Roman Zeyde &#x3C;me@romanzey.de> 1771763419 +0100

v0.11.1
<a data-footnote-ref href="#user-content-fn-1">Good "git" signature for git@romanzey.de with ED25519 key SHA256:GifMn7F2swVKyn6MewbQHrYCs4i/bPK7gnwxhuPz/YA</a>
</code></pre>

* Now compile the source code into an executable binary

{% code overflow="wrap" %}

```bash
ROCKSDB_INCLUDE_DIR=/usr/local/include ROCKSDB_LIB_DIR=/usr/local/lib cargo build --locked --release
```

{% endcode %}

<details>

<summary><strong>Example</strong> of expected output 🔽</summary>

```
info: syncing channel updates for '1.63.0-x86_64-unknown-linux-gnu'
info: latest update on 2022-08-11, rust version 1.63.0 (4b91a6ea7 2022-08-08)
info: downloading component 'cargo'
info: downloading component 'clippy'
info: downloading component 'rust-docs'
info: downloading component 'rust-std'
info: downloading component 'rustc'
info: downloading component 'rustfmt'
info: installing component 'cargo'
info: installing component 'clippy'
info: installing component 'rust-docs'
info: installing component 'rust-std'
info: installing component 'rustc'
info: installing component 'rustfmt'
    Updating crates.io index
  Downloaded hex_lit v0.1.1
  Downloaded humantime v2.1.0
  Downloaded bitflags v1.3.2
  Downloaded getrandom v0.2.10
  Downloaded rand_chacha v0.3.1
  Downloaded is-terminal v0.4.7
  Downloaded lock_api v0.4.10
  Downloaded libloading v0.7.4
  Downloaded jsonrpc v0.14.1
  Downloaded jobserver v0.1.26
  Downloaded thiserror-impl v1.0.40
  Downloaded autocfg v1.1.0
  Downloaded dirs-sys-next v0.1.2
  Downloaded dirs-next v2.0.0
  Downloaded httpdate v1.0.2
  Downloaded configure_me v0.4.0
  Downloaded lazycell v1.3.0
  Downloaded num_cpus v1.16.0
[...]
  Compiling bitcoin_slices v0.10.0
  Compiling crossbeam-channel v0.5.15
  Compiling rust-rocksdb v0.36.0
   Finished `release` profile [optimized] target(s) in 7m 17s
```

</details>

{% hint style="info" %}
This process can take quite **a long time**, 10-15 minutes or more, depending on the performance of your device. Please be patient until the prompt shows again
{% endhint %}

* Install it

{% code overflow="wrap" %}

```bash
sudo install -m 0755 -o root -g root -t /usr/local/bin ./target/release/electrs
```

{% endcode %}

* Check the correct installation

```sh
electrs --version
```

**Example** of expected output:

```
v0.10.0
```

* **(Optional)** Delete the temporal `electrs` folder

```sh
sudo rm -r /tmp/electrs
```

* Return to the home folder

```bash
cd
```

{% hint style="success" %}
If you come to update, this is the final step
{% endhint %}

### Create the electrs user & group <a href="#create-the-bitcoin-user-and-group" id="create-the-bitcoin-user-and-group"></a>

* Create the `electrs` user

```sh
sudo adduser --disabled-password --gecos "" electrs
```

* Make to the `electrs` user a member of the "bitcoin" group

```sh
sudo adduser electrs bitcoin
```

* Create the Electrs data directory

```sh
sudo mkdir /data/electrs
```

* Assign the owner to the `electrs` user

```sh
sudo chown electrs:electrs /data/electrs
```

## Configuration

* Switch to the `electrs` user

```sh
sudo su - electrs
```

* Create the electrs config file

```sh
nano /data/electrs/electrs.conf
```

* Enter the complete next content

```
# MiniBolt: electrs configuration
# /data/electrs/electrs.conf

# Bitcoin client settings
network = "bitcoin"
cookie_file = "/data/bitcoin/.cookie"

# Electrs settings
electrum_rpc_addr = "0.0.0.0:50021"
db_dir = "/data/electrs/db"
server_banner = "Welcome to electrs (Electrum Rust Server) running on a MiniBolt node!"
skip_block_download_wait = true

# Allow concurrent DB background operations. e.g., for 4 threads max use.
# Customise with your available threads.
db_parallelism = 4

# Logging
log_filters = "INFO"
```

* Exit `electrs` user session to return to the `admin` user session

```sh
exit
```

### Create systemd service

* As user `admin`, create the Electrs systemd unit

```sh
sudo nano /etc/systemd/system/electrs.service
```

* Enter the following complete configuration. Save and exit

```
# MiniBolt: systemd unit for electrs
# /etc/systemd/system/electrs.service

[Unit]
Description=Electrs
Requires=bitcoind.service
After=bitcoind.service

[Service]
ExecStart=/usr/local/bin/electrs --conf /data/electrs/electrs.conf --skip-default-conf-files

# Process management
####################
Type=simple
TimeoutSec=300
KillMode=process

# Directory creation and permissions
####################################
RuntimeDirectory=electrs
RuntimeDirectoryMode=0710
User=electrs
Group=electrs

# Hardening Measures
####################
PrivateTmp=true
ProtectSystem=full
ProtectHome=true
PrivateDevices=true
MemoryDenyWriteExecute=true

[Install]
WantedBy=multi-user.target
```

* Enable autoboot **(optional)**

```sh
sudo systemctl enable electrs
```

* Prepare "electrs" monitoring by the systemd journal and check the log output. You can exit monitoring at any time with `Ctrl-C`

```sh
journalctl -fu electrs
```

## Run

To keep an eye on the software movements, [start your SSH program](/system/system/remote-access.md#access-with-secure-shell) (eg, PuTTY) a second time, connect to the MiniBolt node, and log in as `admin`

* Start the service

```sh
sudo systemctl start electrs
```

* Monitor the systemd journal in the first session created to check if everything works fine

<details>

<summary><strong>Example</strong> of expected output on the first terminal with <code>journalctl -fu electrs</code> ⬇️</summary>

<pre><code>Starting electrs <a data-footnote-ref href="#user-content-fn-2">0.10.0</a> on x86_64 linux with Config { network: Bitcoin, db_path: "/data/electrs/db/bitcoin", daemon_dir: "/data/bitcoin", daemon_auth: CookieFile("/data/bitcoin/.cookie"), daemon_rpc_addr: 127.0.0.1:8332, daemon_p2p_addr: 127.0.0.1:8333, electrum_rpc_addr: 0.0.0.0:50021, monitoring_addr: 127.0.0.1:4224, wait_duration: 10s, jsonrpc_timeout: 15s, index_batch_size: 10, index_lookup_limit: None, reindex_last_blocks: 0, auto_reindex: true, ignore_mempool: false, sync_once: false, disable_electrum_rpc: false, server_banner: "Welcome to electrs (Electrum Rust Server) running on a MiniBolt node!", args: [] }
[2021-11-09T07:09:42.744Z INFO  electrs::metrics::metrics_impl] serving Prometheus metrics on 127.0.0.1:4224
[2021-11-09T07:09:42.744Z INFO  electrs::server] serving Electrum RPC on 0.0.0.0:50021
[2021-11-09T07:09:42.812Z INFO  electrs::db] "/data/electrs/db/bitcoin": 0 SST files, 0 GB, 0 Grows
[2021-11-09T07:09:43.174Z INFO  electrs::index] indexing 2000 blocks: [1..2000]
[2021-11-09T07:09:44.665Z INFO  electrs::chain] chain updated: tip=00000000dfd5d65c9d8561b4b8f60a63018fe3933ecb131fb37f905f87da951a, height=2000
[2021-11-09T07:09:44.986Z INFO  electrs::index] indexing 2000 blocks: [2001..4000]
[2021-11-09T07:09:46.191Z INFO  electrs::chain] chain updated: tip=00000000922e2aa9e84a474350a3555f49f06061fd49df50a9352f156692a842, height=4000
[2021-11-09T07:09:46.481Z INFO  electrs::index] indexing 2000 blocks: [4001..6000]
[2021-11-09T07:09:47.581Z INFO  electrs::chain] chain updated: tip=00000000dbbb79792303bdd1c6c4d7ab9c21bba0667213c2eca955e11230c5a5, height=6000
[2021-11-09T07:09:46.481Z INFO  electrs::index] indexing 2000 blocks: [6001..8000]
[2021-11-09T07:09:47.581Z INFO  electrs::chain] chain updated: tip=00000000dbbb79792303bdd1c6c4d7ab9c21bba0667213c2eca955e11230c5a6, height=8000
[2021-11-09T07:09:46.481Z INFO  electrs::index] indexing 2000 blocks: [8001..10000]
[2021-11-09T07:09:47.581Z INFO  electrs::chain] chain updated: tip=00000000dbbb79792303bdd1c6c4d7ab9c21bba0667213c2eca955e11230c5a7, height=10000
[...]
[2021-11-09T07:09:46.481Z INFO  electrs::index] indexing 65 blocks: [756001..756065]
[2021-11-09T07:09:47.581Z INFO  electrs::chain] chain updated: tip=00000000dbbb79792303bdd1c6c4d7ab9c21bba0667213c2eca955e11230c510, height=756065
[2021-11-09T07:09:47.581Z INFO  electrs::db] starting config compaction
[2021-11-09T07:09:47.581Z INFO  electrs::db] starting headers compaction
[2021-11-09T07:09:47.581Z INFO  electrs::db] starting txid compaction
[2021-11-09T07:09:47.581Z INFO  electrs::db] starting funding compaction
[2021-11-09T07:09:47.581Z INFO  electrs::db] starting spending compaction
[...]
</code></pre>

</details>

{% hint style="success" %}
Congrats! Now you have a self-hosted Electrum Server on your node. Now you can proceed with installing the [Blockchain Explorer: BTC RPC Explorer](/bitcoin/bitcoin/btc-rpc-explorer.md), or connect your [Desktop signing app: Sparrow Wallet](/bitcoin/bitcoin/sparrow.md) or [Electrum Wallet ](/bonus-guides/bitcoin/electrum-wallet-desktop.md)[Desktop](/bonus-guides/bitcoin/electrum-wallet-desktop.md)
{% endhint %}

### Validation

* Ensure electrs service is working and listening on the default TCP `50021` port and the monitoring `14224` port (not used on MiniBolt)

```sh
sudo ss -tulpn | grep electrs
```

Expected output:

```
tcp   LISTEN 0      128          0.0.0.0:50021      0.0.0.0:*    users:(("electrs",pid=54749,fd=4))
tcp   LISTEN 0      128        127.0.0.1:14224      0.0.0.0:*    users:(("electrs",pid=54749,fd=3))
```

* And the SSL `50022` port

```bash
sudo ss -tulpn | grep 50022
```

Expected output:

```
tcp   LISTEN 0   511   0.0.0.0:50022   0.0.0.0:*    users:(("nginx",pid=719,fd=5),("nginx",pid=718,fd=5),("nginx",pid=717,fd=5),("nginx",pid=716,fd=5),("nginx",pid=715,fd=5))
```

{% hint style="info" %}
Electrs must first fully index the blockchain and compact its database before you can connect to it with your wallets. This can take a few hours. Only proceed with the [next section](/bitcoin/bitcoin/sparrow.md) once Electrs is ready
{% endhint %}

## Extras (optional)

### Remote access over Tor

To use your Electrum server when you're on the go, you can easily create a Tor hidden service. This way, you can connect the BitBoxApp or Electrum wallet remotely, or even share the connection details with friends and family. Note that the remote device needs to have Tor installed as well.

* With the user `admin`, edit the `torrc` file

```sh
sudo nano +63 /etc/tor/torrc --linenumbers
```

* Add the following lines in the "location hidden services" section, below "`## This section is just for location-hidden services ##`" in the torrc file. Save and exit

```
# Hidden Service Electrs TCP & SSL
HiddenServiceDir /var/lib/tor/hidden_service_electrs_tcp_ssl/
HiddenServiceEnableIntroDoSDefense 1
HiddenServicePoWDefensesEnabled 1
HiddenServicePort 50021 127.0.0.1:50021
HiddenServicePort 50022 127.0.0.1:50022
```

* Reload the Tor configuration to apply changes

```sh
sudo systemctl reload tor
```

* Get your Onion address

```sh
sudo cat /var/lib/tor/hidden_service_electrs_tcp_ssl/hostname
```

Expected output:

```
abcdefg..............xyz.onion
```

{% hint style="info" %}
You should now be able to connect to your Electrs server remotely via Tor using your hostname and port `50022 (SSL)` , or `50021 (TCP)`
{% endhint %}

## Upgrade

* First, ensure that you have the latest Rustc version, following the [Upgrade section](/bonus-guides/system/rustup-cargo.md#upgrade) of the [Rustup + Cargo bonus guide](/bonus-guides/system/rustup-cargo.md)
* Follow the complete [Build from the source code](#build-from-the-source-code) section
* When you finish, restart Electrs to apply the new version

```sh
sudo systemctl restart electrs
```

* Check logs and pay attention to the next log if that refers to the new version installed, and no error logs

```bash
journalctl -fu electrs
```

<details>

<summary><strong>Example</strong> of expected output ⬇️</summary>

```
Starting electrs 0.10.0 on x86_64 linux with Config { network: Bitcoin, db_path: "/data/electrs/db/bitcoin", daemon_dir: "/data/bitcoin", daemon_auth: CookieFile("/data/bitcoin/.cookie"), daemon_rpc_addr: 127.0.0.1:8332, daemon_p2p_addr: 127.0.0.1:8333, electrum_rpc_addr: 0.0.0.0:50021, monitoring_addr: 127.0.0.1:4224, wait_duration: 10s, jsonrpc_timeout: 15s, index_batch_size: 10, index_lookup_limit: None, reindex_last_blocks: 0, auto_reindex: true, ignore_mempool: false, sync_once: false, disable_electrum_rpc: false, server_banner: "Welcome to electrs (Electrum Rust Server) running on a MiniBolt node!", args: [] }
[2021-11-09T07:09:42.744Z INFO  electrs::metrics::metrics_impl] serving Prometheus metrics on 127.0.0.1:4224
[2021-11-09T07:09:42.744Z INFO  electrs::server] serving Electrum RPC on 0.0.0.0:50021
[2021-11-09T07:09:42.812Z INFO  electrs::db] "/data/electrs/db/bitcoin": 0 SST files, 0 GB, 0 Grows
[2021-11-09T07:09:43.174Z INFO  electrs::index] indexing 2000 blocks: [1..2000]
[2021-11-09T07:09:44.665Z INFO  electrs::chain] chain updated: tip=00000000dfd5d65c9d8561b4b8f60a63018fe3933ecb131fb37f905f87da951a, height=2000
[2021-11-09T07:09:44.986Z INFO  electrs::index] indexing 2000 blocks: [2001..4000]
[2021-11-09T07:09:46.191Z INFO  electrs::chain] chain updated: tip=00000000922e2aa9e84a474350a3555f49f06061fd49df50a9352f156692a842, height=4000
[2021-11-09T07:09:46.481Z INFO  electrs::index] indexing 2000 blocks: [4001..6000]
[2021-11-09T07:09:47.581Z INFO  electrs::chain] chain updated: tip=00000000dbbb79792303bdd1c6c4d7ab9c21bba0667213c2eca955e11230c5a5, height=6000
[2021-11-09T07:09:46.481Z INFO  electrs::index] indexing 2000 blocks: [6001..8000]
[2021-11-09T07:09:47.581Z INFO  electrs::chain] chain updated: tip=00000000dbbb79792303bdd1c6c4d7ab9c21bba0667213c2eca955e11230c5a6, height=8000
[2021-11-09T07:09:46.481Z INFO  electrs::index] indexing 2000 blocks: [8001..10000]
[2021-11-09T07:09:47.581Z INFO  electrs::chain] chain updated: tip=00000000dbbb79792303bdd1c6c4d7ab9c21bba0667213c2eca955e11230c5a7, height=10000
[...]
[2021-11-09T07:09:46.481Z INFO  electrs::index] indexing 65 blocks: [756001..756065]
[2021-11-09T07:09:47.581Z INFO  electrs::chain] chain updated: tip=00000000dbbb79792303bdd1c6c4d7ab9c21bba0667213c2eca955e11230c510, height=756065
[2021-11-09T07:09:47.581Z INFO  electrs::db] starting config compaction
[2021-11-09T07:09:47.581Z INFO  electrs::db] starting headers compaction
[2021-11-09T07:09:47.581Z INFO  electrs::db] starting txid compaction
[2021-11-09T07:09:47.581Z INFO  electrs::db] starting funding compaction
[2021-11-09T07:09:47.581Z INFO  electrs::db] starting spending compaction
[...]
```

</details>

## Uninstall

{% hint style="danger" %}
Warning: This section removes the installation. Only run these commands if you intend to uninstall
{% endhint %}

### Uninstall service

* With the user `admin`, stop electrs

```bash
sudo systemctl stop electrs
```

* Disable autoboot (if enabled)

```bash
sudo systemctl disable electrs
```

* Delete the service

```bash
sudo rm /etc/systemd/system/electrs.service
```

### Delete user & group

* Ensure you are logged in as the user `admin`. Delete the `electrs` user.\
  Don't worry about `userdel: electrs mail spool (/var/mail/electrs) not found` output, the uninstall has been successful

```bash
sudo userdel -rf electrs
```

### Delete data directory

* Delete the electrs directory

```bash
sudo rm -rf /data/electrs
```

### Uninstall Tor hidden service

* Ensure that you are logged in as the user `admin` , edit the `torrc` config file

```bash
sudo nano +63 /etc/tor/torrc --linenumbers
```

* Delete or comment on the following lines in the "location hidden services" section, below "`## This section is just for location-hidden services ##`" in the torrc file. Save and exit

```
# Hidden Service Electrs TCP & SSL
#HiddenServiceDir /var/lib/tor/hidden_service_electrs_tcp_ssl/
#HiddenServiceEnableIntroDoSDefense 1
#HiddenServicePoWDefensesEnabled 1
#HiddenServicePort 50021 127.0.0.1:50021
#HiddenServicePort 50022 127.0.0.1:50022
```

* Reload the Tor configuration to apply changes

```bash
sudo systemctl reload tor
```

### Uninstall reverse proxy & FW configuration

* Ensure you are logged in as the user `admin`, delete the reverse proxy config file

```bash
sudo rm /etc/nginx/sites-available/electrs-reverse-proxy.conf
```

* Delete the symbolic link

```bash
sudo rm /etc/nginx/sites-enabled/electrs-reverse-proxy.conf
```

* Test Nginx configuration

```bash
sudo nginx -t
```

Expected output:

```
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
```

* Reload the Nginx configuration to apply changes

```bash
sudo systemctl reload nginx
```

* Display the UFW firewall rules, and note the numbers of the rules for Electrs (e.g., X and Y below)

```bash
sudo ufw status numbered
```

Expected output:

```
[Y] 50021       ALLOW IN    Anywhere          # allow Electrs TCP from anywhere
[X] 50022       ALLOW IN    Anywhere          # allow Electrs SSL from anywhere
```

* Delete the rule with the correct number and confirm with "`yes`" and enter

```bash
sudo ufw delete X
```

## Port reference

<table><thead><tr><th align="center">Port</th><th width="109">Protocol<select><option value="PM9OdZyqffcj" label="TCP" color="blue"></option><option value="fow02dq4Lt4x" label="SSL" color="blue"></option><option value="HHci4T1IS7Pb" label="UDP" color="blue"></option></select></th><th align="center">Use</th></tr></thead><tbody><tr><td align="center">50021</td><td><span data-option="PM9OdZyqffcj">TCP</span></td><td align="center">TCP port</td></tr><tr><td align="center">50022</td><td><span data-option="fow02dq4Lt4x">SSL</span></td><td align="center">SSL port</td></tr></tbody></table>

[^1]: Check this

[^2]: Current version installed