mirror of
https://github.com/mempool/mempool.git
synced 2024-12-27 08:44:26 +01:00
308 lines
9.8 KiB
Markdown
308 lines
9.8 KiB
Markdown
# Deploying an Enterprise Production Instance
|
|
|
|
These instructions are for setting up a serious production Mempool website for Bitcoin (mainnet, testnet, signet), Liquid (mainnet, testnet), and Bisq.
|
|
|
|
Again, this setup is no joke—home users should use [one of the other installation methods](../#installation-methods).
|
|
|
|
### Server Hardware
|
|
|
|
Mempool v2 is powered by [blockstream/electrs](https://github.com/Blockstream/electrs), which is a beast.
|
|
|
|
I recommend a beefy server:
|
|
|
|
* 20-core CPU (more is better)
|
|
* 64GB RAM (more is better)
|
|
* 4TB SSD (NVMe is better)
|
|
|
|
### HDD vs SSD vs NVMe
|
|
|
|
If you don't have a fast SSD or NVMe-backed disk, that's fine—go online and buy some fast new NVMe drives. When they arrive, install them, throw away your old HDDs, and then proceed with the rest of this guide.
|
|
|
|
## FreeBSD 13
|
|
|
|
The mempool.space site is powered by FreeBSD with ZFS root and ARC cache for maximum performance. Linux probably works fine too, but why settle?
|
|
|
|
### Filesystem
|
|
|
|
For maximum performance, I use 2x 2TB NVMe SSDs in a RAID 0 using ZFS with lots of RAM for the ARC L2 cache.
|
|
```
|
|
% zpool list -v
|
|
NAME SIZE ALLOC FREE CKPOINT EXPANDSZ FRAG CAP DEDUP HEALTH ALTROOT
|
|
nvm 3.62T 1.25T 2.38T - - 2% 34% 1.00x ONLINE -
|
|
nvd0p3 1.81T 629G 1.20T - - 2% 33.9% - ONLINE
|
|
nvd1p3 1.81T 646G 1.18T - - 2% 34.8% - ONLINE
|
|
```
|
|
|
|
For maximum flexibility of configuration, I recommend separate partitions for each data folder:
|
|
```
|
|
Filesystem Size Used Avail Capacity Mounted on
|
|
nvm/bisq 766G 1.1G 765G 0% /bisq
|
|
nvm/bitcoin 766G 648M 765G 0% /bitcoin
|
|
nvm/bitcoin/blocks 1.1T 375G 765G 33% /bitcoin/blocks
|
|
nvm/bitcoin/chainstate 770G 4.5G 765G 1% /bitcoin/chainstate
|
|
nvm/bitcoin/electrs 772G 7.3G 765G 1% /bitcoin/electrs
|
|
nvm/bitcoin/indexes 799G 34G 765G 4% /bitcoin/indexes
|
|
nvm/bitcoin/testnet3 765G 5.0M 765G 0% /bitcoin/testnet3
|
|
nvm/bitcoin/testnet3/blocks 786G 21G 765G 3% /bitcoin/testnet3/blocks
|
|
nvm/bitcoin/testnet3/chainstate 766G 1.1G 765G 0% /bitcoin/testnet3/chainstate
|
|
nvm/bitcoin/testnet3/indexes 768G 2.9G 765G 0% /bitcoin/testnet3/indexes
|
|
nvm/electrs 765G 128K 765G 0% /electrs
|
|
nvm/electrs/liquid 765G 104K 765G 0% /electrs/liquid
|
|
nvm/electrs/liquid/cache 765G 7.8M 765G 0% /electrs/liquid/newindex/cache
|
|
nvm/electrs/liquid/history 766G 886M 765G 0% /electrs/liquid/newindex/history
|
|
nvm/electrs/liquid/txstore 775G 10G 765G 1% /electrs/liquid/newindex/txstore
|
|
nvm/electrs/liquidtestnet 765G 112K 765G 0% /electrs/liquidtestnet
|
|
nvm/electrs/liquidtestnet/cache 765G 96K 765G 0% /electrs/liquidtestnet/newindex/cache
|
|
nvm/electrs/liquidtestnet/history 765G 96K 765G 0% /electrs/liquidtestnet/newindex/history
|
|
nvm/electrs/liquidtestnet/txstore 765G 96K 765G 0% /electrs/liquidtestnet/newindex/txstore
|
|
nvm/electrs/mainnet 765G 112K 765G 0% /electrs/mainnet
|
|
nvm/electrs/mainnet/cache 765G 4.4M 765G 0% /electrs/mainnet/newindex/cache
|
|
nvm/electrs/mainnet/history 1.0T 300G 765G 28% /electrs/mainnet/newindex/history
|
|
nvm/electrs/mainnet/txstore 1.3T 530G 765G 41% /electrs/mainnet/newindex/txstore
|
|
nvm/electrs/signet 766G 522M 765G 0% /electrs/signet
|
|
nvm/electrs/testnet 765G 104K 765G 0% /electrs/testnet
|
|
nvm/electrs/testnet/cache 765G 1.6M 765G 0% /electrs/testnet/newindex/cache
|
|
nvm/electrs/testnet/history 784G 19G 765G 2% /electrs/testnet/newindex/history
|
|
nvm/electrs/testnet/txstore 803G 38G 765G 5% /electrs/testnet/newindex/txstore
|
|
nvm/elements 766G 927M 765G 0% /elements
|
|
nvm/elements/electrs 766G 716M 765G 0% /elements/electrs
|
|
nvm/elements/liquidv1 777G 11G 765G 1% /elements/liquidv1
|
|
nvm/mempool 789G 24G 765G 3% /mempool
|
|
nvm/mysql 766G 648M 765G 0% /mysql
|
|
tmpfs 1.0G 1.3M 1.0G 0% /var/cache/nginx
|
|
tmpfs 3.0G 1.9G 1.1G 63% /bisq/statsnode-data/btc_mainnet/db/json
|
|
```
|
|
|
|
### Build Dependencies
|
|
|
|
You'll probably need these:
|
|
```
|
|
pkg install -y zsh sudo git screen curl wget neovim rsync nginx openssl openssh-portable py38-pip py38-certbot-nginx boost-libs autoconf automake gmake gcc libevent libtool pkgconf mariadb105-server mariadb105-client
|
|
```
|
|
|
|
### Node.js + npm
|
|
|
|
Build Node.js v16.15 and npm v8 from source using `nvm`:
|
|
```
|
|
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh
|
|
source $HOME/.zshrc
|
|
nvm install v16.15.0
|
|
nvm alias default node
|
|
```
|
|
|
|
### Rust
|
|
|
|
Build Rust from latest source:
|
|
```
|
|
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
|
|
```
|
|
|
|
### Tor
|
|
|
|
Install Tor add Bitcoin to the `_tor` group:
|
|
```
|
|
pkg install -y tor
|
|
pw user mod bitcoin -G _tor
|
|
```
|
|
|
|
Then configure `/usr/local/etc/tor/torrc` as follows:
|
|
```
|
|
RunAsDaemon 1
|
|
SOCKSPort 9050
|
|
ControlPort 9051
|
|
Log notice syslog
|
|
|
|
CookieAuthentication 1
|
|
CookieAuthFileGroupReadable 1
|
|
CookieAuthFile /var/db/tor/control_auth_cookie
|
|
DataDirectory /var/db/tor
|
|
DataDirectoryGroupReadable 1
|
|
|
|
HiddenServiceDir /var/db/tor/mempool
|
|
HiddenServicePort 80 127.0.0.1:81
|
|
HiddenServiceVersion 3
|
|
|
|
HiddenServiceDir /var/db/tor/bisq
|
|
HiddenServicePort 80 127.0.0.1:82
|
|
HiddenServiceVersion 3
|
|
|
|
HiddenServiceDir /var/db/tor/liquid
|
|
HiddenServicePort 80 127.0.0.1:83
|
|
HiddenServiceVersion 3
|
|
```
|
|
|
|
### Bitcoin
|
|
|
|
Build [Bitcoin Core](https://github.com/bitcoin/bitcoin) from source. Alternatively, install the OS packages:
|
|
```
|
|
pkg install -y bitcoin-daemon bitcoin-utils
|
|
```
|
|
|
|
Configure your `bitcoin.conf` like this:
|
|
```
|
|
datadir=/bitcoin
|
|
server=1
|
|
txindex=1
|
|
listen=1
|
|
discover=1
|
|
par=16
|
|
dbcache=4096
|
|
maxmempool=1337
|
|
mempoolexpiry=999999
|
|
maxconnections=42
|
|
onion=127.0.0.1:9050
|
|
rpcallowip=127.0.0.1
|
|
rpcuser=foo
|
|
rpcpassword=bar
|
|
|
|
[main]
|
|
bind=127.0.0.1:8333
|
|
rpcbind=127.0.0.1:8332
|
|
whitelist=bloomfilter@127.0.0.1
|
|
|
|
[test]
|
|
daemon=1
|
|
bind=127.0.0.1:18333
|
|
rpcbind=127.0.0.1:18332
|
|
|
|
[signet]
|
|
daemon=1
|
|
bind=127.0.0.1:38333
|
|
rpcbind=127.0.0.1:38332
|
|
```
|
|
|
|
### Elements
|
|
|
|
Build [Elements Core](https://github.com/ElementsProject/elements) from source:
|
|
```
|
|
./autogen.sh
|
|
MAKE=gmake CC=cc CXX=c++ CPPFLAGS=-I/usr/local/include \
|
|
./configure --with-gui=no --disable-wallet
|
|
gmake -j19
|
|
gmake install
|
|
```
|
|
|
|
Configure your `elements.conf` like this:
|
|
```
|
|
server=1
|
|
daemon=1
|
|
listen=1
|
|
rpcuser=foo
|
|
rpcpassword=bar
|
|
mainchainrpchost=127.0.0.1
|
|
mainchainrpcuser=foo
|
|
mainchainrpcpassword=bar
|
|
txindex=1
|
|
|
|
[liquidv1]
|
|
validatepegin=1
|
|
mainchainrpcport=8332
|
|
|
|
[liquidtestnet]
|
|
validatepegin=0
|
|
anyonecanspendaremine=0
|
|
initialfreecoins=2100000000000000
|
|
con_dyna_deploy_start=0
|
|
con_max_block_sig_size=150
|
|
checkblockindex=0
|
|
fallbackfee=0.00000100
|
|
con_has_parent_chain=0
|
|
parentgenesisblockhash=NULL
|
|
pubkeyprefix=36
|
|
scriptprefix=19
|
|
blindedprefix=23
|
|
bech32_hrp=tex
|
|
blech32_hrp=tlq
|
|
pchmessagestart=410edd62
|
|
dynamic_epoch_length=1000
|
|
signblockscript=51210217e403ddb181872c32a0cd468c710040b2f53d8cac69f18dad07985ee37e9a7151ae
|
|
evbparams=dynafed:0:::
|
|
addnode=liquid-testnet.blockstream.com:18892
|
|
addnode=liquidtestnet.com:18891
|
|
addnode=liquid.network:18444
|
|
```
|
|
|
|
Start `elementsd` and wait for it to sync the Liquid blockchain.
|
|
|
|
### Electrs
|
|
|
|
Install [Electrs](https://github.com/Blockstream/electrs) from source:
|
|
```
|
|
git clone https://github.com/Blockstream/electrs
|
|
cd electrs
|
|
git checkout new-index
|
|
```
|
|
|
|
You'll need one instance per network. Build and run them one at a time:
|
|
```
|
|
./electrs-start-mainnet
|
|
./electrs-start-testnet
|
|
./electrs-start-signet
|
|
./electrs-start-liquid
|
|
./electrs-start-liquidtestnet
|
|
```
|
|
|
|
### MariaDB
|
|
|
|
Import the historical mempool fee database snapshot:
|
|
```
|
|
mysql -u root
|
|
create database mempool;
|
|
grant all on mempool.* to 'mempool'@'localhost' identified by 'mempool';
|
|
create database mempool_testnet;
|
|
grant all on mempool_testnet.* to 'mempool_testnet'@'localhost' identified by 'mempool_testnet';
|
|
create database mempool_signet;
|
|
grant all on mempool_signet.* to 'mempool_signet'@'localhost' identified by 'mempool_signet';
|
|
create database mempool_liquid;
|
|
grant all on mempool_liquid.* to 'mempool_liquid'@'localhost' identified by 'mempool_liquid';
|
|
create database mempool_liquidtestnet;
|
|
grant all on mempool_liquidtestnet.* to 'mempool_liquidtestnet'@'localhost' identified by 'mempool_liquidtestnet';
|
|
```
|
|
|
|
|
|
### Bisq
|
|
|
|
Build bisq-statsnode normally and run using options like this:
|
|
```
|
|
./bisq-statsnode --dumpBlockchainData=true --dumpStatistics=true
|
|
```
|
|
|
|
If Bisq is happy, it should dump JSON files for Bisq Markets and BSQ data into `/bisq` for the Mempool backend to use.
|
|
|
|
### Mempool
|
|
|
|
After all 3 electrs instances are fully indexed, install your 3 Mempool nodes:
|
|
```
|
|
./mempool-install-all
|
|
./mempool-upgrade-all
|
|
```
|
|
|
|
Finally, start your 3 Mempool backends:
|
|
```
|
|
./mempool-start-all
|
|
```
|
|
|
|
### Nginx
|
|
|
|
Get an SSL certificate using `certbot`:
|
|
```
|
|
certbot --nginx -d mempool.ninja
|
|
```
|
|
|
|
Make a symlink from `/usr/local/etc/nginx/mempool` to `/mempool/mempool`, copy the `nginx.conf`, and edit as necessary. You probably only need to edit the top-level `nginx.conf` file.
|
|
```
|
|
cd /usr/local/etc/nginx
|
|
ln -s /mempool/mempool
|
|
cp /mempool/mempool/nginx.conf .
|
|
vi nginx.conf
|
|
```
|
|
|
|
Restart `nginx`:
|
|
```
|
|
service nginx restart
|
|
```
|
|
|
|
### Done
|
|
|
|
If everything went well, your site should look like the one at https://mempool.space/.
|