Installare il centralino 3CX su Raspberry Pi 5

Introduzione

Questa guida illustra la procedura di installazione dell’SBC 3CX su Raspberry Pi 5.

L’SBC 3CX supporta il sistema operativo Raspberry Pi basato su Debian-12 (Bookworm) e Debian-13 (Trixie).

Importante: 3CX raccomanda l’uso di Raspberry Pi OS a 64 bit (arm64) per tutte le installazioni su Raspberry Pi 5. La versione a 32 bit (armhf) potrebbe ancora funzionare, ma non viene più testata né convalidata regolarmente da 3CX.

Passo 1: Procurarsi il Raspberry Pi corretto

  • Un Raspberry Pi 5 - 4 GB/8 GB
  • Una scheda microSD affidabile, preferibilmente con certificazione di resistenza.
  • La capacità minima della scheda è di 32 GB; se desideri gestire file di log più grandi a scopo di risoluzione dei problemi, dovresti prendere in considerazione una capacità maggiore.
  • Assicurati che il dispositivo abbia un buon involucro che consenta il massimo raffreddamento.
  • Una custodia con raffreddamento attivo o un Raspberry Pi Active Cooler.
  • Un alimentatore USB-C da 5 V, 5 A di alta qualità.
  • Idealmente l’alimentatore ufficiale per il Raspberry Pi 5.

Passo 2: Preparare una scheda SD con il sistema operativo Raspberry Pi

  • Scaricare Raspberry Pi Imager e installarlo. La documentazione completa di Imager è disponibile alla pagina indicata nel link.
  • Eseguire il programma, selezionare Raspberry Pi 5 e cliccare su AVANTI

  • Nella scheda del sistema operativo, scorri verso il basso e scegli Raspberry Pi OS (altro), quindi cliccarci sopra.

  • Scegliere la versione corretta di Debian Bookworm o Trixie Raspberry Pi OS Lite per il tuo Raspberry e clicca su AVANTI:
  • 64 bit (arm64) - Consigliata. Utilizzare questa opzione per tutte le nuove installazioni su Raspberry Pi 5. Si tratta dell'architettura testata e convalidata da 3CX.
  • 32 bit (armhf) - Solo per compatibilità con le versioni precedenti. La versione a 32 bit potrebbe continuare a funzionare, ma non è più testata né convalidata da 3CX. La compatibilità futura non è garantita.

  • Scegliere la scheda SD che desideri preparare:
  • Tieni selezionata l’opzione Escludi unità di sistema per evitare rischi accidentali alle tue unità di sistema
  • Conferma la tua scelta
  • Si consiglia di eseguire ora i passaggi di personalizzazione; se li salti, al primo avvio sul Pi verrà eseguita una procedura guidata con le stesse opzioni

  • Inserire un nome host
  • Impostare il fuso orario e la tastiera
  • Creare il tuo account utente predefinito e imposta una password complessa che potrai ricordare
  • L'SBC deve utilizzare una connessione Ethernet cablata; il Wi-Fi non è supportato.
  • Decidere come ti collegherai al tuo Raspberry dopo l'installazione:
  • SSH con autenticazione tramite password o chiave pubblica
  • Raspberry Pi Connect

  • Verifica che le informazioni rilevanti nella sezione “Riepilogo” siano quelle previste, quindi scrivi l'immagine sulla scheda SD.
  • Prima di iniziare la scrittura, Imager scaricherà l’ultima versione disponibile dal repository di Raspberry.

Passo 3: Avviare il tuo Raspberry Pi

  • Inserisci nel Pi la scheda SD appena preparata
  • Avvia il Pi
  • Connettersi tramite console, SSH o Pi Connect

Passo 4: Impostare un IP statico

  • Esegui il comando nmtui:

sudo nmtui

  • Scegliere “Modifica una connessione”.
  • Selezionare la tua connessione di rete.
  • Impostare IPv4 su “Manuale” e clicca su “Mostra”.
  • Impostare l’indirizzo, il gateway e il server DNS in base alle tue impostazioni LAN, quindi premi “OK”.
  • Cliccare su “Indietro” e poi su “Esci” per uscire dalla procedura guidata
  • Riavviare il Pi:

sudo reboot

  • Al termine del riavvio del Pi, effettuare l’accesso con l’utente creato e verificare l’indirizzo IP di “eth0”:

ip a

Nota: le installazioni LAN sono supportate su reti private RFC 1918 correttamente configurate:

  • 10.0.0.0/8
  • 172.16.0.0/12
  • 192.168.0.0/16

Passo 5: Aggiungere l’SBC al tuo 3CX

  • Accedere alla Admin Console 3CX e andare su “Voce e chat”.
  • Cliccare su “+ Aggiungi SBC”, selezionare “Raspberry Pi” e cliccare su “Continua”.
  • La connessione SBC è stata ora creata sul lato centralino ed è in attesa che l’SBC effettivo si connetta.

Passo 6: Installare l'SBC 3CX sul Raspberry Pi

  • Accedere al Raspberry Pi con l'account utente principale, tramite CLI o SSH.
  • Eseguire lo script di installazione di 3CX:

sudo bash -c "$(wget -qO- https://downloads-global.3cx.com/downloads/sbc/3cxsbc.zip)"

  • Selezionare OK per verificare i “Prerequisiti 3CX” e accettare il “Contratto di licenza con l'utente finale” per continuare.
  • Inserire l'“URL di provisioning” per il proprio 3CX (ad es. https://example-pbx.3cx.com) e selezionare OK.
  • Inserisci l’“ID chiave di autenticazione” e selezionare OK.
  • Selezionare OK e procedi con l’installazione e il riavvio.

Passo 7: Configurazione dei telefoni IP

Una volta installato l’SBC, è possibile configurare i tuoi telefoni IP tramite questo SBC, selezionandolo come opzione di connessione durante la configurazione del telefono IP.

Per saperne di più

Ultimo aggiornamento
Questo documento è stato aggiornato il 23 luglio 2026.
https://www.3cx.it/doc/manuale/installare-pbx-raspberry-pi/