Instalando 3CX no Raspberry Pi 5

Introdução

Este guia tem como objetivo orientar a instalação do SBC 3CX no Raspberry Pi 5.

O SBC 3CX é compatível com o Sistema Operacional Raspberry Pi baseado no Debian-12 (Bookworm) e no Debian-13 (Trixie).

Importante: A 3CX recomenda o Raspberry Pi OS de 64 bits (arm64) para todas as instalações no Raspberry Pi 5. A versão de 32 bits (armhf) ainda pode funcionar, mas não é mais testada nem validada regularmente pela 3CX.

Etapa 1: Obtenha o Raspberry Pi Correto

• Um Raspberry Pi 5 – 4 GB/8 GB
• Um cartão microSD de boa reputação, de preferência com classificação de resistência.

• O tamanho mínimo do cartão é de 32 Gb; se você deseja lidar com arquivos de log maiores para fins de solução de problemas, deve considerar um cartão de maior capacidade.

• Certifique-se de que o dispositivo tenha uma case que permita o máximo resfriamento.

• Um gabinete com refrigeração ativa ou um Raspberry Pi Active Cooler.

• Um carregador USB-C de alta qualidade, com 5 V e 5 A.

• O ideal é usar a fonte de alimentação oficial do Raspberry Pi 5.

Etapa 2: Prepare um Cartão SD com o Raspberry Pi OS

• Baixe o Raspberry Pi Imager e instale-o. A documentação completa do Imager pode ser encontrada na página indicada no link.

• Execute o Imager, selecione Raspberry Pi 5 e clique em PRÓXIMO

• No cartão do Sistema Operacional, role a tela para baixo, escolha Raspberry Pi OS (outros) e clique nele.

• Escolha o Debian Bookworm ou Trixie Raspberry Pi OS Lite correto para o seu Raspberry e clique em PRÓXIMO

• 64 bits (arm64) — Recomendado. Use essa opção para todas as novas instalações do Raspberry Pi 5. Essa é a arquitetura testada e validada pela 3CX.
• 32 bits (armhf) — Apenas compatibilidade com versões antigas. A versão de 32 bits pode continuar funcionando, mas não é mais testada nem validada pela 3CX. A compatibilidade futura não é garantida.

• Escolha o cartão SD que você deseja preparar

• Mantenha a opção Excluir unidades do sistema marcada para evitar riscos acidentais às suas unidades do sistema
• Confirme sua escolha

• É recomendável realizar as etapas de Personalização agora; caso você as pule, um assistente com as mesmas opções será executado no Pi na primeira inicialização

• Digite um nome de host
• Defina seu fuso horário e seu teclado
• Crie sua Conta de usuário padrão e defina uma senha forte que você consiga lembrar
• O SBC deve utilizar Ethernet com fio; o WiFi não é compatível.
• Decida como você se conectará ao seu Raspberry após a instalação:

• SSH com autenticação por senha ou por chave pública
• Conexão do Raspberry Pi

• Verifique se as informações relevantes no Índice estão corretas e grave a imagem no seu cartão SD.

• O Imager fará o download da versão mais recente disponível no repositório da Raspberry antes de iniciar a gravação.

Etapa 3: Inicialize o Seu Raspberry Pi

• Insira o cartão SD que acabou de ser preparado no Pi
• Inicialize o Pi
• Conecte-se a ele pelo Console, SSH ou Pi Connect

Etapa 4: Configurar um Endereço IP Estático

• Execute o comando nmtui:

sudo nmtui



• Selecione Editar uma conexão.
• Selecione sua conexão de rede.
• Defina o IPv4 como Manual e clique em <Mostrar>.
• Defina o Endereço, o Gateway e o servidor DNS de acordo com as suas Configurações de LAN e pressione <OK>.
• Clique em “Voltar” e “Sair” para encerrar o Assistente
• Reinicie o Pi:

sudo reboot



• Quando o Pi terminar de reiniciar, faça login com o usuário que você criou e verifique o endereço IP da "eth0":

ip a



Observação: as instalações em LAN são compatíveis com redes privadas RFC 1918 devidamente configuradas:

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

Etapa 5: Adicione o SBC ao Seu PABX 3CX

• Faça login no Console de Admin 3CX e navegue até Voz e Chat.
• Clique em + Adicionar SBC, selecione Raspberry Pi e clique em Continuar.
• A conexão com o SBC já foi criada no lado do PABX e está aguardando que o próprio SBC se conecte.

Etapa 6: Instale o SBC 3CX no Seu Raspberry Pi

• Faça login no Raspberry Pi com a conta de usuário principal, por meio da CLI ou do SSH.
• Execute o script de instalação do 3CX:

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



• Selecione OK para verificar os “Pré-requisitos do 3CX” e aceitar o “Contrato de Licença de Usuário Final” para continuar.
• Digite a “URL de Provisionamento” do seu 3CX (por exemplo, https://example-PABX.3cx.com) e selecione OK.
• Digite o “ID da CHAVE de Autenticação” e selecione OK.
• Selecione OK e prossiga com a instalação e a reinicialização.

Etapa 7: Provisione Seus Telefones IP

Depois que o SBC estiver instalado, você poderá configurar seus Telefones IP por meio desse SBC, selecionando-o como opção de conexão durante a configuração do Telefone IP.

Veja Também

• Instalação de um SBC 3CX
• Aprenda a Criar e Converter Chaves OpenSSH
• Como configurar um cluster SBC HA (Alta Disponibilidade).

Última Atualização

Este documento foi atualizado pela última vez em 23 de julho de 2026

https://www.3cx.com.br/docs/manual/instalando-pbx-raspberry-pi/