> ## 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 hospedagem

> Aprenda a publicar seu site e a usar domínios gratuitos ou personalizados

Publicar torna o seu projeto disponível na internet. O Macaly cuida de hospedagem, implantação e SSL para você, então não é preciso configurar servidores nem conectar serviços de terceiros.

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

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

Pense nele como o nome público do seu site. Quando alguém abre esse endereço, o navegador carrega o conteúdo do seu projeto. No Macaly, você não precisa configurar isso de antemão. Ao publicar o projeto, você ganha automaticamente um domínio funcionando, e seu site já fica acessível.

## **Subdomínio gratuito do Macaly**

Todo projeto publicado no Macaly vai ao ar em um subdomínio gratuito do Macaly, por exemplo:

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

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

Assim você entra no ar na hora. Você pode usar esse link para ver a prévia do site, compartilhá-lo com outras pessoas ou lançá-lo sem se preocupar com domínios ou hospedagem. Você pode continuar com o subdomínio do Macaly ou trocar depois por um domínio personalizado, sem alterar o projeto.

## **Domínio personalizado**

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

Se quiser que o seu site fique no seu próprio domínio, você precisa de um plano Starter, Pro ou Agência (ou de um plano Hospedagem já existente). O Macaly oferece duas opções:

* Conectar um domínio que você já tem, de qualquer registrador
* Comprar e registrar um novo domínio direto no Macaly, usando créditos

<Tip>
  O Macaly faz parte do [ecossistema team.blue](https://team.blue/ecosystem/), que reúne provedores locais de hospedagem e domínios de confiança em toda a Europa, como Active24 (CZ), Websupport (SK), Combell (BE), Register.it (IT) e muitos outros. Se você precisa de um registrador de domínios, eles são uma boa opção.
</Tip>

## **Como publicar seu site ou app**

<Steps>
  <Step title="Publique seu projeto">
    Clique em **Publicar** no canto superior direito do editor. O Macaly compila e implanta automaticamente a versão mais recente do seu projeto.

    Quando a publicação terminar, seu site estará no ar em um subdomínio gratuito do Macaly, pronto para ser compartilhado ou conectado a um domínio personalizado.

    No plano Gratuito você pode ter 1 app publicado. Publicar um novo app exige uma vaga livre. Cancele a publicação de um app para liberar uma vaga (ela é liberada em alguns minutos) ou mude para um plano superior. Rascunhos e prévias não contam. Se você já tem mais apps no ar do que seu plano inclui, veja [Apps publicados acima do limite](/docs/pt-BR/account/workspaces/usage#apps-publicados-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="Publicação do projeto no Macaly" width="2168" height="1356" data-path="images/new-DOMAINS&HOSTING1.png" />
  </Step>

  <Step title="Conecte um domínio que você já tem">
    Abra **Configurações → Domínios**, digite o seu domínio e clique em **Conectar**. O Macaly mostra os registros DNS exatos que você precisa adicionar. Copie esses valores para as configurações de DNS do seu provedor de domínio. Depois que o domínio for verificado, o Macaly mostra o status do certificado SSL de cada endereço. Se aparecer **Certificado SSL ausente**, clique em **Tentar emitir o certificado SSL novamente**.

    <img src="https://mintcdn.com/macaly-41b1d3e9/nsRC1lPYDUod7gDZ/images/new-DOMAINS&HOSTING2.png?fit=max&auto=format&n=nsRC1lPYDUod7gDZ&q=85&s=0991ffb9e6a3df38b8ae12bccff3fca9" alt="Conectando um domínio próprio no Macaly" width="2168" height="1356" data-path="images/new-DOMAINS&HOSTING2.png" />
  </Step>

  <Step title="Compre e conecte um domínio no Macaly">
    Abra **Configurações → Domínios**, pesquise um nome de domínio e confira 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="Pesquisando um domínio para comprar no Macaly" 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="Comprando e conectando um domínio no Macaly" width="2168" height="1356" data-path="images/new-DOMAINS&HOSTING4.png" />
  </Step>
</Steps>

## **Domínio de API para o backend do seu app**

Apps com banco de dados também recebem um endereço estável para o backend, no formato `yourapp.api.macaly.app`. Ele atende as partes do app que outros sistemas chamam diretamente: webhooks de serviços como o Stripe, uma API pública ou o [servidor MCP](/docs/pt-BR/features/app-mcp) do seu app.

O domínio de API é separado do endereço do seu site. Ele é derivado do seu banco de dados e nunca muda, então você pode passá-lo uma vez a um terceiro e esquecer o assunto. Publicar em um domínio personalizado não o afeta.

Normalmente o Macaly configura o domínio de API junto com o banco de dados. Se o seu app ainda não tiver um, peça ao agente: "Configure um domínio de API para este app."

## **Hospedagem**

O Macaly cuida da hospedagem e da implantação para você, com tecnologia da **Vercel**. Quando você publica um projeto, ele é implantado automaticamente, servido com segurança por HTTPS e otimizado por padrão para desempenho e SEO. Você não precisa gerenciar servidores, certificados SSL nem um provedor de hospedagem separado.

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

Os domínios personalizados exigem o plano **Starter**, **Pro** ou **Agência**, ou um plano Hospedagem já existente. O [Starter](/docs/pt-BR/welcome/pricing) (\$10/mês) dá direito a 1 app publicado no seu próprio domínio personalizado, sem o selo do Macaly. A compra do domínio é cobrada à parte. O plano Gratuito fica em um subdomínio do Macaly.

<Note>
  O plano Hospedagem deixou de ser oferecido a novos clientes. Se você já está no Hospedagem, continua com o mesmo plano, preço e recursos, e ainda pode gerenciá-lo ou cancelá-lo em [Cobrança](/docs/pt-BR/account/billing).
</Note>

## **Perguntas frequentes**

<AccordionGroup>
  <Accordion title="Como conecto meu próprio domínio personalizado?">
    No seu projeto, acesse **Configurações → Domínios**, digite o nome do seu domínio e clique em **Conectar**. O Macaly mostra os registros DNS que você precisa adicionar. Acesse o registrador do seu domínio e adicione o registro A e o registro CNAME como indicado. Depois de salvar os registros, volte ao Macaly e clique em **Atualizar**. Conectar um domínio personalizado exige o plano Starter, Pro ou Agência, ou um plano Hospedagem já existente.
  </Accordion>

  <Accordion title="Quais registros DNS preciso adicionar para o meu domínio personalizado?">
    Normalmente você precisa de dois registros:

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

    Os valores exatos aparecem em **Configurações → Domínios** quando você adiciona o domínio.
  </Accordion>

  <Accordion title="Meu site funciona com www, mas mostra um erro de SSL no domínio sem www. Como corrijo?">
    Adicione um registro A para o domínio raiz (apex) apontando para o endereço IP do Macaly (`216.150.1.1`). Remova quaisquer registros A ou AAAA conflitantes do domínio raiz. Se o domínio raiz mostrar **Certificado SSL ausente** em **Configurações → Domínios** mesmo com os registros corretos, clique em **Tentar emitir o certificado SSL novamente**. Você pode tentar uma vez por hora. [Entre em contato com o suporte](mailto:support@macaly.com) se não tiver certeza de quais registros remover.
  </Accordion>

  <Accordion title="Meu domínio ainda aparece como Pendente ou Não conectado. O que devo fazer?">
    Confira se os registros DNS no seu registrador são exatamente iguais aos que o Macaly mostra. Remova quaisquer registros conflitantes. Clique em **Atualizar** no painel de Domínios do Macaly. A propagação do DNS pode levar até 24 horas.
  </Accordion>

  <Accordion title="Ainda posso contratar o plano Hospedagem para usar um domínio personalizado?">
    Não. O plano Hospedagem deixou de ser oferecido a novos clientes. Para usar um domínio personalizado, escolha o plano Starter (\$10/mês) ou o Pro. Se você já está no Hospedagem, continua com o mesmo plano, preço e recursos, e ainda pode gerenciá-lo ou cancelá-lo em **Cobrança**.
  </Accordion>

  <Accordion title="Posso configurar e-mail para o meu domínio personalizado?">
    O Macaly não oferece hospedagem de e-mail. Para ter e-mail no seu domínio personalizado (por exemplo, [info@seusite.com](mailto:info@seusite.com)), contrate um provedor terceirizado, como Google Workspace, Zoho ou Microsoft 365, e configure os registros MX deles no seu registrador. Com o endereço de e-mail pronto, o agente do Macaly pode configurar formulários de contato para enviar notificações a ele.
  </Accordion>
</AccordionGroup>


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