Come installare BTCPay Server: guida tecnica completa per principianti

Introduzione

Installare BTCPay Server richiede un VPS Linux, Docker e circa 1–2 ore di configurazione. In questa guida vediamo ogni passaggio nel dettaglio. Se preferisci saltare la parte tecnica, puoi usare il nostro hosting gestito pronto in 24 ore.

Requisiti minimi

• 🖥️ VPS: 2 vCPU, 4 GB RAM, 80 GB SSD (500 GB per full node Bitcoin)
• 🐧 Sistema operativo: Ubuntu 22.04 LTS (consigliato)
• 🌐 Dominio: un dominio o sottodominio puntato al VPS (es. btcpay.tuodominio.it)
• 🔒 Porta 443: aperta per HTTPS (SSL automatico via Let’s Encrypt)

Passo 1: Preparazione del VPS

# Aggiorna il sistema
sudo apt update && sudo apt upgrade -y

# Installa Docker
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

# Installa Docker Compose
sudo apt install docker-compose-plugin -y

Passo 2: Installazione BTCPay Server

# Scarica lo script di installazione
git clone https://github.com/btcpayserver/btcpayserver-docker
cd btcpayserver-docker

# Configura le variabili d'ambiente
export BTCPAY_HOST="btcpay.tuodominio.it"
export NBITCOIN_NETWORK="mainnet"
export BTCPAYGEN_CRYPTO1="btc"
export BTCPAYGEN_LIGHTNING="lnd"
export BTCPAYGEN_REVERSEPROXY="nginx"
export BTCPAYGEN_ADDITIONAL_FRAGMENTS="opt-save-storage"

# Avvia l'installazione
. ./btcpay-setup.sh -i

Passo 3: Prima configurazione

1. Accedi a https://btcpay.tuodominio.it
2. Crea l’account amministratore
3. Crea il primo store
4. Collega il wallet Bitcoin (inserisci solo la xpub, mai la seed phrase)
5. Attiva Lightning Network e apri i primi canali

Passo 4: Sincronizzazione del nodo

Il full node Bitcoin deve sincronizzare tutta la blockchain (~500 GB). Questo processo richiede 24–72 ore alla prima installazione. Durante la sincronizzazione non puoi ancora ricevere pagamenti on-chain.

Suggerimento: usa l’opzione opt-save-storage per usare un nodo pruned (meno spazio richiesto).

Alternativa: hosting gestito

Se la parte tecnica ti spaventa o non hai tempo, il nostro hosting BTCPay Server gestito è pronto in 24 ore: nessuna configurazione, aggiornamenti automatici, supporto in italiano.

Conclusione

Installare BTCPay Server è fattibile con le giuste competenze tecniche. Per chi preferisce concentrarsi sul business, il nostro hosting gestito è la soluzione più rapida e sicura. Contattaci per iniziare.