When regulators want to enforce identity verification on a social platform, they send a letter to the company that runs the servers. M4TR1X has no such company and no such servers — only nodes run by individuals.
The EU's push toward mandatory identity verification for social platforms — through the DSA, age verification proposals, and digital identity schemes — assumes that social infrastructure has a center: a company, a server, a database to hand over. m4tr1x-node is designed to have none of those things. Anyone can run one. No one owns the network.
Every node that comes online makes the network more resilient and harder to disable by targeting a single point. Running a node is not just using the network — it is the network.
A M4TR1X node is a self-hosted backend that:
- Runs a Nostr relay — receives and stores signed events (posts, messages, metadata) from users
- Runs a Blossom blob store — stores binary content (videos, photos, music) addressed by SHA-256 hash
- Serves HLS video streams — transcodes and segments video for playback
- Hosts photo and story posts — stores and serves image content for feeds and stories
- Runs the AI detector — on-node inference to flag AI-generated video content
All content is stored locally on the node operator's machine. There is no central storage. Content is replicated across nodes according to demand.
Node operators earn 30% of every tip that passes through their node, paid automatically in H8 tokens at the time of the transaction. No invoicing, no dashboard, no withdrawal request.
- Node.js 18+
- ffmpeg (for HLS transcoding)
- Minimum 20 GB disk space (more is better)
- A static IP or dynamic DNS (recommended for public-facing nodes)
git clone https://github.com/H8dboy/m4tr1x-node.git
cd m4tr1x-node
npm install
cp .env.example .envEdit .env:
NODE_PORT=3000
STORAGE_PATH=./data
TOR_ENABLED=true
FOUNDER_PUBKEY=<founder_pubkey>
NODE_PRIVKEY=<your_node_keypair_privkey>Start:
npm startThe node will announce itself to the network and begin accepting connections.
┌──────────────────────────────────────────────────┐
│ m4tr1x-node │
│ │
│ ┌─────────────┐ ┌──────────────────────────┐ │
│ │ Nostr Relay │ │ Blossom Blob Store │ │
│ │ (WebSocket) │ │ (SHA-256 addressed) │ │
│ └──────┬──────┘ └────────────┬─────────────┘ │
│ │ │ │
│ ┌──────▼──────────────────────▼─────────────┐ │
│ │ Express API │ │
│ │ HLS transcoder │ Photo/story handler │ │
│ │ Tip processor │ AI detector bridge │ │
│ └───────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────┐ │
│ │ Tor Hidden Service │ │
│ │ (automatic if TOR_ENABLED=true) │ │
│ └──────────────────────────────────────────┘ │
└──────────────────────────────────────────────────┘
| Module | Description |
|---|---|
relay/ |
Nostr relay — stores and forwards signed events |
blossom/ |
Blob store — content addressed by SHA-256 |
hls/ |
Video transcoding and segmented streaming |
media/ |
Photo and story post handler |
ai-detector/ |
Bridge to m4tr1x-ai-detector |
tips/ |
H8 token tip processing and operator payout |
tor/ |
Tor hidden service management |
- Node identity: ML-DSA-65 keypair (NIST FIPS-204)
- All content verified by SHA-256 hash before storage
- Nostr events validated against cryptographic signatures before relay
- No user credentials stored on the node — identity lives on the client
Enabled by default. On startup the node creates a Tor hidden service and publishes its .onion address to the network. Clients on censored networks route through Tor automatically. Disable with TOR_ENABLED=false in .env.
Once your node is running, open the M4TR1X desktop app (m4tr1x-electron) and add your node address under Settings → Nodes.
See docs/NODE_OPERATOR.md for the complete setup guide including firewall configuration, storage management, and performance tuning.
Read CONTRIBUTING.md. Security issues go to SECURITY.md.
MIT — see LICENSE.
Part of the M4TR1X project — built by @H8dboy — Brescia, Italy