> For the complete documentation index, see [llms.txt](https://docs.plenit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plenit.com/docs-pt/productos/servers/how-to/how-to-deploy-a-3cx-template.md).

# Como Implementar um Modelo 3CX num Servidor da Plenit

O 3CX é uma plataforma de comunicações unificadas e central telefónica (PBX) baseada em Debian. Na Plenit, implementas a partir do **Marketplace**, o que agiliza a provisão inicial e deixa a configuração web do 3CX pronta para ser concluída depois.

> #### 👍 O que consegues
>
> Um servidor com o 3CX implementado a partir do Marketplace e o seu assistente de configuração web acessível pela porta 5015.

### Antes de começar

* Iniciar sessão na plataforma da Plenit.
* Ter uma Subscrição de **Servidores** disponível.
* Decidir que IP pública usarás para publicar a porta **5015** durante a configuração inicial.

> #### 📘 Duas coisas depois do deployment
>
> Quando o servidor estiver criado, abre a sua **consola** para ativar o acesso remoto à administração web e publica a **porta 5015** no Firewall. Vês isso no Passo 2.

### Passo 1. Implementa o template 3CX

Entra na subscrição de **Servidores** e clica em **Novo servidor** para abrir o assistente. A partir daí:

1. Seleciona a **localização** e clica em **Seguinte**.
2. Escolhe o **tamanho** (CPU e RAM) e clica em **Seguinte**.
3. Abre o separador **Marketplace**, clica na imagem de **3CX**, escolhe a versão e o **idioma** e clica em **Seguinte**.
4. Escolhe o **tamanho do Disco** e clica em **Seguinte**.
5. Configura a **Rede** e clica em **Seguinte**.
6. No ecrã final, cria uma etiqueta e uma chave SSH se precisares, assinala **Open SSH port to Access the service** só se fores administrar por terminal, atribui um **nome** e clica em **Criar servidor**.

> #### 📘 Dimensiona de acordo com o teu ambiente
>
> A recomendação mínima para o 3CX é 1 CPU com 2 cores e 2 GB de RAM. Atribui mais recursos se o ambiente o exigir.

Quando o deployment começa, verás o servidor no estado **A carregar** e uma notificação de criação. Quando terminar, podes continuar com a configuração inicial do 3CX.

![Seleção do 3CX, da sua versão e do seu idioma no Marketplace](https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FVOsYGaSpUVWaYefQCuCa%2Fservidores-plantilla-3cx-01.png?alt=media\&token=b27ebd57-49aa-4eec-afc5-6df1b491d1ad)

### Passo 2. Prepara o sistema 3CX

> #### 🚧 Primeiro a consola, depois a porta
>
> A porta 5015 não serve de nada até ativares o acesso web a partir da consola. Faz este passo antes de abrir o Firewall.

Volta ao frontend da Plenit e abre a **consola** do servidor. Seleciona a opção **1** para ativar o acesso remoto à administração web inicial. A consola inicia a ferramenta web de configuração e mostra um URL com o IP privada do servidor e a porta 5015. Como o servidor está na Cloud, para entrares a partir do exterior terás de usar a sua IP pública em vez da privada: por isso o passo seguinte é publicar essa porta.

![Consola do 3CX com a opção para ativar a configuração web](https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2FbtwAlUiJAhl5KD1YSNRC%2Fservidores-plantilla-3cx-02.png?alt=media\&token=1a173a6a-165b-4899-97c8-568b2ea3c82a)

Depois, na parte inferior da configuração do servidor, clica em **Nova regra de entrada** e cria uma regra **NAT** (redirecionamento entre o IP pública e o IP privada do servidor) para publicar a 5015:

* **Seleciona a Rede**: normalmente, deixa-a como está.
* **IP ou Rede**: um IP ou intervalo de origem, ou **Qualquer IP** para permitir qualquer Rede.
* **Protocolo**: TCP.
* **IP pública**: o IP pública através do qual a ligação é atendida.
* **Porta pública**: 5015, a mesma que usarás para validar o acesso.
* **IP privada**: o IP interna do servidor 3CX.
* **Porta privada**: **5015**.

Clica em **Continuar** e confirma que a regra aparece na lista do Firewall.

![Criação da regra NAT para a porta 5015 do 3CX](https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Flw7H1lZ5ZI74OiTsdtFe%2Fservidores-plantilla-3cx-03.png?alt=media\&token=51203d8c-7537-4af6-9fff-5aa33155a482)

> 👍 Reduz a exposição do acesso inicial
>
> A 5015 é a porta de entrada para a administração da tua central telefónica. Sempre que puderes:
>
> * Preenche **IP ou Rede** com um IP ou intervalo específico em vez de **Qualquer IP**.
> * Abre a 5015 apenas durante a configuração inicial e remove ou restringe a regra quando terminares.
> * Assinala **Open SSH port** e usa a chave SSH só se realmente fores administrar por terminal.

### Validação

Abre no navegador `http://IP_Publica:5015`, substituindo `IP_Publica` pelo IP pública da regra. Se carregar, verás o ecrã **Configure your 3CX Install**, com as opções de carregar uma nova configuração ou restaurar uma Cópia de segurança, e já podes seguir com o assistente web.

Para confirmar a partir do terminal:

```bash
curl -I http://<IP-PUBLICA>:5015
```

### Se algo não bater certo

| Sintoma                              | Causa provável                       | O que fazer                                                  |
| ------------------------------------ | ------------------------------------ | ------------------------------------------------------------ |
| `http://IP:5015` não responde        | Não ativaste o acesso web na consola | Abre a consola e escolhe a opção **1**                       |
| Continua sem abrir                   | A regra não publica bem a 5015       | Confirma que a regra existe e que a **Porta privada** é 5015 |
| Liga-se a outra máquina ou não chega | IPs mal atribuídos na regra          | Verifica que **IP pública** e **IP privada** são os corretos |
| Responde a outros, mas a ti não      | `IP ou Rede` te deixa fora           | Garante que o teu IP está no intervalo permitido             |

<br>

### Conclusão

Com isto tens o 3CX implementado a partir do Marketplace e o seu assistente web pronto na 5015. A chave do processo são dois gestos por ordem: ativar o acesso web a partir da consola e, só depois, publicar a porta. E como se trata de uma central telefónica, fecha ou restringe essa 5015 assim que terminares a configuração inicial: não convém deixar a administração aberta à Internet mais tempo do que o necessário.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.plenit.com/docs-pt/productos/servers/how-to/how-to-deploy-a-3cx-template.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
