> 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 template 3CX num servidor da Plenit

3CX é uma plataforma de comunicações unificadas e central telefónica (PBX) baseada em Debian. No Plenit, implementas a partir do **Marketplace**, o que agiliza o aprovisionamento 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 vais usar para publicar a porta **5015** durante a configuração inicial.

> #### 📘 Duas coisas depois da implementação
>
> Quando o servidor estiver criado, abre a sua **consola** para habilitar 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**, seleciona o **idioma** e clica em **Seguinte**.
4. Escolhe o **tamanho de 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 delas, marca **Abrir a porta SSH para aceder ao serviço** apenas 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 3CX é 1 CPU com 2 cores e 2 GB de RAM. Atribui mais recursos se o ambiente o exigir.

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

{/\* 📸 CAPTURA 1 · separador Marketplace com a imagem de 3CX e o seletor de idioma \*/}

![Seleção do 3CX e do seu idioma no Marketplace](https://REEMPLAZA-URL/servidores-howto-3cx-01.png)

### Passo 2. Prepara o sistema 3CX

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

Volta ao front-end do Plenit e abre a **consola** do servidor. Seleciona a opção **1** para habilitar o acesso remoto à administração web inicial. A consola indicar-te-á que deves abrir a porta **5015** para aceder à aplicação.

{/\* 📸 CAPTURA 2 · consola do servidor com a opção 1 para habilitar o acesso web \*/}

![Consola do 3CX com a opção para habilitar a configuração web](https://REEMPLAZA-URL/servidores-howto-3cx-02.png)

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

* **Select network**: normalmente, deixa-a como está.
* **Origens**: um IP ou intervalo de origem, ou **Qualquer IP** para permitir qualquer rede.
* **Protocolo**: deixa o valor que o modelo mostra.
* **IP Pública**: o IP público pelo qual a ligação é atendida.
* **IP privada**: o IP interno do servidor 3CX.
* **Porta privada**: **5015**.

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

{/\* 📸 CAPTURA 3 · Nova regra de entrada (NAT) a publicar a porta 5015 \*/}

![Criação da regra NAT para a porta 5015 do 3CX](https://REEMPLAZA-URL/servidores-howto-3cx-03.png)

> 👍 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:
>
> * Usa **Origens** com um IP ou intervalo concreto em vez de **Qualquer IP**.
> * Abre a 5015 apenas durante a configuração inicial e remove ou restringe a regra quando terminares.
> * Marca **Abrir porta SSH** e usa a chave SSH apenas se realmente fores administrar por terminal.

### Validação

Abre no navegador `http://IP_Pública:5015`, substituindo `IP_Pública` pelo IP público da regra. Se carregar, verás o ecrã **Configura a tua instalação 3CX**, com as opções de carregar uma nova configuração ou restaurar uma cópia de segurança, e já podes continuar com o assistente web.

Para confirmar a partir do terminal:

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

### Se algo não encaixar

| Sintoma                              | Causa provável                          | O que fazer                                                  |
| ------------------------------------ | --------------------------------------- | ------------------------------------------------------------ |
| `http://IP:5015` não responde        | Não habilitaste o acesso web na consola | Abre a consola e escolhe a opção **1**                       |
| Ainda não abre                       | A regra não publica corretamente o 5015 | Verifica que a regra existe e que o **Porta privada** é 5015 |
| Liga-te a outra máquina ou não chega | IPs mal atribuídos na regra             | Confirma que **IP Pública** e **IP privada** são os corretos |
| Responde a outros, mas a ti não      | `Origens` deixa-te fora                 | Assegura-te de 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: habilitar 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 esse 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.