RaMiX

Build your own "DIY" Bitcoin & Lightning node, and other stuff on a Raspberry Pi. No need to trust anyone else.

Attention!! This guide is in the WIP (work in progress) state and hasn't been tested yet. Many steps may be incorrect. Pay special attention to the "Status: Not tested on RaMiX" tag at the beginning of the guides. Be careful and act behind your responsibility.

What is the RaMiX?

With this guide, you can set up a Bitcoin, Lightning node, and other stuff on a Raspberry Pi, doing everything yourself. You will learn about Linux, Bitcoin, Lightning, and much more.

There are many reasons why you should run your own Bitcoin node:

👥 Keep Bitcoin decentralized: use your node to help enforce your Bitcoin consensus rules.

🗽 Take back your sovereignty: let your node validate your Bitcoin transactions. No need to ask someone else to tell you what's happening in the Bitcoin network.

🥷🏽 Improve your privacy: connect your wallets to your node so you no longer need to reveal your financial history to external servers.

⚡️ Be part of Lightning: run your Lightning node for everyday payments and help build a robust and decentralized Lightning network.

RaMiX overview

This guide explains setting up your Bitcoin node on a Raspberry Pi. However, it works on most hardware platforms because it only uses standard Debian-based Linux commands.

Features

Your Bitcoin node will offer the following functionality:

🟠 Bitcoin: direct and trustless participation in the Bitcoin peer-to-peer network, full validation of blocks and transactions

⚛️ Electrum server: connect your compatible wallets (including hardware wallets) to your node

⛓️ Blockchain Explorer: web-based Explorer to privately look up transactions, blocks, and more

⚡ Lightning: full client with stable long-term channels and web-based and mobile-based management interfaces

🔋 Always on: services are constantly synced and available 24/7

🌐 Reachable from anywhere: connect to all your services through the Tor network and Wireguard VPN

Target audience

• We strive to give foolproof instructions. But the goal is also to do everything ourselves.

• Shortcuts that involve trusting someone else are not allowed. This makes this guide quite technical, but we try to make it as straightforward as possible.

• You'll gain a basic understanding of the how and why.

• If you want to learn about Linux, Bitcoin, and Lightning, this guide is for you.

Structure

We aim to keep the core of this guide well-maintained and up-to-date:

🖥️ System

Prepare the hardware and set up the operating system

1.2 Operating system

1.3 Remote access

🟠 ₿itcoin

Sync your own Bitcoin full node, Electrum server, Blockchain Explorer, and connect a desktop wallet to the Electrum server

2.2 Electrum Server: Fulcrum

2.3 Blockchain explorer: BTC RPC Explorer

⚡ Lightning

Run your Lightning client with web-based node management, connect a mobile app, and save safely your SCB backup

3.2 Channel backup for LND

3.3 Web app: ThunderHub

➕ Bonus guides

The bonus section contains more specific guides that build on top of the main section. More fun, lots of knowledge, but with lesser maintenance guarantees. Everything is optional.

🖥️System

₿itcoin

🦩Nostr

Community

👥 RRSS 👥

• Telegram Groups:

  • English

  • Spanish

• Nostr channels:

  • English

  • Spanish

• Telegram Channels (News):

  • English

  • Spanish

🛠️ GitHub 🛠️

• Pull requests

• Issues / Knowledge base

• Discussions

Feel free to join the many other contributors if you see something that can be improved!

Resources

🌐 Network map

🛣️ Roadmap

📅 Launchpad (Calendar)

📺 Streams

Free services

Nostr relay

Use a Nostr client to connect

• Nostr relay in Rust (🚾clearnet):

wss://relay.minibolt.info

• Nostr relay in Rust (🧅onion):

ws://xib7qeea6f5nz3ueko4kwcsddpvggdray4nhagcvofbioot3n2qrapid.onion

Electrum server

Explorer

Keyserver

Rating

All guides are rated with labels to help you assess their difficulty and whether they are tested against the most recent version of the main guide.

• Difficulty: indicates how difficult the bonus guide is in terms of installation procedure or usage

Difficulty: Easy

Difficulty: Medium

Difficulty: Hard

• Cost: indicates if the service used in the guide is free or paid

Cost: Paid service

• Status: indicates if the guide has been tested on a RaMiX environment or not

Status: Not tested on RaMiX

Port reference

Port	Protocol	Use
🖥️ SYSTEM
22	TCP	Default SSH server
9050	TCP	Default Tor SOCKS
9051	TCP	Default Tor control
7656	TCP	Default I2P SAM proxy
7070	TCP	Default I2Pd web console HTTP
7071	SSL	I2Pd web console HTTPS
🟠 ₿ITCOIN
8332	TCP	Default Bitcoin Core RPC
8333	TCP	Default Bitcoin Core P2P
8334	TCP	Default Bitcoin Core P2P Tor
50001	TCP	Fulcrum TCP
50002	SSL	Fulcrum SSL
8000	TCP	Fulcrum Admin
3002	TCP	Default BTC RPC Explorer HTTP
4000	SSL	BTC RPC Explorer HTTPS
⚡ LIGHTNING
9735	TCP	Default LND P2P
10009	TCP	Default LND gRPC
9911	TCP	Default LND Watchtower server
3001	TCP	Default ThunderHub HTTP
4002	SSL	ThunderHub HTTPS
8080	TCP	LND REST
➕ BONUS GUIDES
5432	TCP	Default PostgreSQL relational DB
51820	UDP	Default WireGuard VPN
Random	TCP	Random Cloudflared
<TODO1>	TCP	obfs4 bridge OR port
<TODO2>	TCP	obfs4 port
9001	TCP	OR port Guard/Middle relay
9052	TCP	Tor obfs4 bridge control port
9053	TCP	Tor Guard/Middle relay control port
50021	TCP	Electrs TCP
50022	SSL	Electrs SSL
48333	TCP	Default Bitcoin Core P2P Testnet4
48334	TCP	Default Bitcoin Core P2P Testnet4 Tor secondary
48332	TCP	Default Bitcoin Core RPC Testnet4
40001	TCP	Fulcrum Testnet4 TCP
40002	SSL	Fulcrum Testnet4 SSL
40021	TCP	Electrs Testnet4 TCP
40022	SSL	Electrs Testnet4 SSL
24444	TCP	Default NBXplorer
23000	TCP	Default BTCPay Server
8880	TCP	Default Nostr relay
8090	TCP	Default Alby Hub HTTP
3003	SSL	Alby Hub SSL HTTPS
4040	SSL	Public Pool HTTPS
23334	TCP	Default Public Pool API
23333	TCP	Default Stratum