> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Domínios e alojamento

> Sabe como publicar o teu site e usar domínios gratuitos ou personalizados

Publicar torna o teu projeto disponível na internet. O Macaly trata do alojamento, da implementação e do SSL por ti, por isso não precisas de configurar servidores nem de ligar serviços de terceiros.

## **O que é um domínio?**

Um domínio é o endereço que as pessoas escrevem no navegador para visitar o teu site, como [example.com](http://example.com).

Pensa nele como o nome público do teu site. Quando alguém abre esse endereço, o navegador carrega o conteúdo do teu projeto. No Macaly, não precisas de configurar isto antecipadamente. Publicar o teu projeto dá-te automaticamente um domínio a funcionar, para que o teu site fique imediatamente acessível.

## **Subdomínio Macaly gratuito**

Cada projeto Macaly publicado fica disponível num subdomínio Macaly gratuito, por exemplo:

```
https://myproject.macaly.app
```

<Note>
  Projetos mais antigos podem ter um endereço terminado em `macaly-app.com`. Esses continuam a funcionar como antes.
</Note>

Isto permite-te ficar online instantaneamente. Podes usar este link para pré-visualizar o teu site, partilhá-lo com outras pessoas ou lançá-lo sem te preocupares com domínios ou alojamento. Podes continuar a usar o subdomínio Macaly ou mudar mais tarde para um domínio personalizado sem alterar o teu projeto.

## **Domínio personalizado**

Um domínio personalizado é um endereço com a tua marca, como [example.com](http://example.com).

Se quiseres que o teu site viva no teu próprio domínio, precisas de um plano Starter, Pro ou Agências (ou de um plano Hosting existente). O Macaly dá-te duas opções:

* Ligar um domínio que já possuis, de qualquer registo
* Comprar e registar um novo domínio diretamente no Macaly, usando créditos

<Tip>
  O Macaly faz parte do [ecossistema team.blue](https://team.blue/ecosystem/), que inclui fornecedores locais de alojamento e domínios de confiança em toda a Europa, como a Active24 (CZ), a Websupport (SK), a Combell (BE), a Register.it (IT), e muitos outros. Se precisares de um registo de domínios, estes são uma opção natural.
</Tip>

## **Como publicar o teu site ou app**

<Steps>
  <Step title="Publica o teu projeto">
    Clica em **Publicar** no canto superior direito do editor. O Macaly compila e implementa automaticamente a versão mais recente do teu projeto.

    Assim que a publicação terminar, o teu site fica ativo num subdomínio Macaly gratuito, pronto a ser partilhado ou ligado a um domínio personalizado.

    No plano Grátis podes ter 1 app publicada. Publicar uma nova app exige uma vaga livre. Despublica uma app para libertar uma vaga (fica livre em poucos minutos) ou muda para um plano superior. Os rascunhos e as pré-visualizações não contam. Se já tens mais apps online do que o teu plano inclui, vê [Apps publicadas acima do limite](/docs/pt/account/workspaces/usage#apps-publicadas-acima-do-limite).

    <img src="https://mintcdn.com/macaly-41b1d3e9/nsRC1lPYDUod7gDZ/images/new-DOMAINS&HOSTING1.png?fit=max&auto=format&n=nsRC1lPYDUod7gDZ&q=85&s=5acdf607ea91645a21da9a9b224ae900" alt="New DOMAINS&HOSTING1" width="2168" height="1356" data-path="images/new-DOMAINS&HOSTING1.png" />
  </Step>

  <Step title="Ligar um domínio que já possuis">
    Abre **Definições → Domínios**, introduz o teu domínio e clica em **Ligar**. O Macaly mostra-te os registos DNS exatos que precisas de adicionar. Copia estes valores para as definições DNS do teu fornecedor de domínios. Depois de o domínio ser verificado, o Macaly mostra o estado do certificado SSL de cada endereço. Se aparecer **Certificado SSL em falta**, clica em **Tentar novamente o certificado SSL**.

    <img src="https://mintcdn.com/macaly-41b1d3e9/nsRC1lPYDUod7gDZ/images/new-DOMAINS&HOSTING2.png?fit=max&auto=format&n=nsRC1lPYDUod7gDZ&q=85&s=0991ffb9e6a3df38b8ae12bccff3fca9" alt="New DOMAINS&HOSTING2" width="2168" height="1356" data-path="images/new-DOMAINS&HOSTING2.png" />
  </Step>

  <Step title="Comprar e ligar um domínio no Macaly">
    Abre **Definições → Domínios**, procura um nome de domínio e verifica a disponibilidade.

    <img src="https://mintcdn.com/macaly-41b1d3e9/nsRC1lPYDUod7gDZ/images/new-DOMAINS&HOSTING3.png?fit=max&auto=format&n=nsRC1lPYDUod7gDZ&q=85&s=7d554752147140d323fd245f2febed79" alt="New DOMAINS&HOSTING3" width="2168" height="1356" data-path="images/new-DOMAINS&HOSTING3.png" />

    <img src="https://mintcdn.com/macaly-41b1d3e9/nsRC1lPYDUod7gDZ/images/new-DOMAINS&HOSTING4.png?fit=max&auto=format&n=nsRC1lPYDUod7gDZ&q=85&s=6992ad4b208289b2ca775620034db023" alt="New DOMAINS&HOSTING4" width="2168" height="1356" data-path="images/new-DOMAINS&HOSTING4.png" />
  </Step>
</Steps>

## **Domínio de API para o backend da tua app**

As apps com base de dados recebem também um endereço fixo para o seu backend, no formato `atuaapp.api.macaly.app`. Serve as partes da tua app que outros sistemas chamam diretamente: webhooks de serviços como o Stripe, uma API pública ou o [servidor MCP](/docs/pt/features/app-mcp) da tua app.

O domínio de API é separado do endereço do teu site. Deriva da tua base de dados e nunca muda, por isso podes dá-lo uma vez a terceiros e esquecer o assunto. Publicar num domínio personalizado não o afeta.

Normalmente o Macaly configura o domínio de API juntamente com a base de dados. Se a tua app ainda não tiver um, pede ao agente: «Configura um domínio de API para esta app.»

## **Alojamento**

O Macaly trata do alojamento e da implementação por ti, com tecnologia **Vercel**. Quando publicas um projeto, este é implementado automaticamente, servido de forma segura em HTTPS e otimizado para desempenho e SEO por predefinição. Não precisas de gerir servidores, certificados SSL ou um fornecedor de alojamento à parte.

## **Que plano preciso para um domínio personalizado?**

Os domínios personalizados exigem o plano **Starter**, **Pro** ou **Agências**, ou um plano Hosting existente. O [Starter](/docs/pt/welcome/pricing) (8,80 €/mês) dá-te 1 app publicada no teu próprio domínio personalizado, sem o selo do Macaly. A compra do domínio é cobrada à parte. O plano Grátis fica num subdomínio Macaly.

<Note>
  O plano Hosting deixou de ser oferecido a novos clientes. Se já estás no Hosting, manténs o teu plano, o preço e as funcionalidades, e podes continuar a geri-lo ou cancelá-lo em [Faturação](/docs/pt/account/billing).
</Note>

## **Perguntas frequentes**

<AccordionGroup>
  <Accordion title="Como ligo o meu próprio domínio personalizado?">
    No teu projeto, vai a **Definições → Domínios**, escreve o nome do teu domínio e clica em **Ligar**. O Macaly mostra os registos DNS que precisas de adicionar. Vai ao teu registrador de domínios e adiciona o registo A e o registo CNAME como indicado. Depois de guardares os registos, volta ao Macaly e clica em **Atualizar**. Ligar um domínio personalizado requer um plano Starter, Pro ou Agências, ou um plano Hosting existente.
  </Accordion>

  <Accordion title="Que registos DNS preciso de adicionar para o meu domínio personalizado?">
    Normalmente precisas de dois registos:

    * Um **registo A** para o domínio raiz, apontando para o endereço IP do Macaly
    * Um **registo CNAME** para `www`, apontando para o hostname do Macaly

    Os valores exatos são mostrados em **Definições → Domínios** quando adicionas o teu domínio.
  </Accordion>

  <Accordion title="O meu site funciona em www mas mostra um erro de SSL no domínio simples. Como resolvo?">
    Adiciona um registo A para o domínio simples/raiz, apontando para o endereço IP do Macaly (`216.150.1.1`). Remove quaisquer registos A ou AAAA existentes que estejam em conflito para o domínio raiz. Se o domínio raiz mostrar **Certificado SSL em falta** em **Definições → Domínios**, apesar de os registos estarem corretos, clica em **Tentar novamente o certificado SSL**. Podes tentar uma vez por hora. [Contacta o suporte](mailto:support@macaly.com) se não tiveres a certeza de quais registos remover.
  </Accordion>

  <Accordion title="O meu domínio continua a mostrar Pendente ou Não ligado. O que devo fazer?">
    Confirma que os registos DNS no teu registrador correspondem exatamente ao que o Macaly mostra. Remove quaisquer registos em conflito. Clica em **Atualizar** no painel de Domínios do Macaly. A propagação DNS pode demorar até 24 horas.
  </Accordion>

  <Accordion title="Ainda posso comprar o plano Hosting para usar um domínio personalizado?">
    Não. O plano Hosting deixou de ser oferecido a novos clientes. Para usar um domínio personalizado, escolhe o plano Starter (8,80 €/mês) ou o Pro. Se já estás no Hosting, manténs o teu plano, o preço e as funcionalidades, e podes continuar a geri-lo ou cancelá-lo na **Faturação**.
  </Accordion>

  <Accordion title="Posso configurar email para o meu domínio personalizado?">
    O Macaly não fornece alojamento de email. Para email no teu domínio personalizado (por exemplo, [info@oteusite.com](mailto:info@oteusite.com)), regista-te num fornecedor terceiro como o Google Workspace, Zoho ou Microsoft 365, e configura os respetivos registos MX junto do teu registrador. Assim que tiveres um endereço de email, o agente Macaly pode configurar formulários de contacto para lhe enviar notificações.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.