> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/primeiro-acesso/onboarding-novos-assinantes.md). # Onboarding - novos assinantes Primeiros passos após a compra do Z-PRO: e-mail de boas-vindas, preparar o ambiente, instalar, ativar a licença e configurar o sistema. Bem-vindo ao Z-PRO. Este guia mostra o que você recebe após a compra, para que serve cada lugar que você vai usar e qual é o caminho, em 5 passos, até o sistema no ar.
{% hint style="info" %} Você também acompanha esses passos no [Painel do Licenciado](https://painel.zdg.com.br/), na aba **Onboarding**, que reúne os links de todos os portais citados aqui e onde você marca cada passo como concluído. Veja Painel do Licenciado. {% endhint %} *** {% embed url="" %} #### Os e-mails que você recebe Após a confirmação do pagamento, chegam três e-mails automáticos: 1. **Acesso às aulas** ([portal.zdg.com.br](https://portal.zdg.com.br/)): a trilha em vídeo, o instalador e os arquivos de atualização. 2. **Acesso ao Painel do Licenciado** ([painel.zdg.com.br](https://painel.zdg.com.br/)): onde você gerencia a licença. Entre sempre com o e-mail da compra. 3. **Chave de licença:** o código que ativa o Z-PRO depois de instalado. Sem ela não é possível usar o sistema, então localize esse e-mail e salve a chave para aplicar após a instalação. {% hint style="warning" %} **Cuidados com a chave de licença:** * Guarde em local seguro. A chave fica **só no e-mail**, não no portal. * **Não compartilhe:** toda instalação feita com a sua chave aparece na sua conta, no Painel do Licenciado. {% endhint %} {% hint style="info" %} Não recebeu algum dos e-mails? Verifique a caixa de spam. Se não estiver lá, abra um chamado administrativo em [suporte.zdg.com.br](https://suporte.zdg.com.br/) pedindo o reenvio. {% endhint %} *** #### Onde fica cada coisa | Onde | Para quê | | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | | **Portal** — [portal.zdg.com.br](https://portal.zdg.com.br/) | Aprender em ordem e baixar o instalador e os pacotes de atualização | | **Central de ajuda** — [ajuda.zdg.com.br](https://ajuda.zdg.com.br/) | Pesquisar a documentação de cada funcionalidade e integração (muitos artigos têm vídeo), erros e o changelog | | **Painel do Licenciado** — [painel.zdg.com.br](https://painel.zdg.com.br/) | Gerenciar a licença: visão geral, renovação, números, canais, domínios, atividades e o onboarding | | **Suporte** — [suporte.zdg.com.br](https://suporte.zdg.com.br/) | Abrir chamado técnico ou administrativo e acompanhar as respostas | | [**Telegram**](https://t.me/+mzRfVk-Qe7VlZDIx) | Avisos de novas versões, hotfixes e informações relevantes aos assinantes | | **Roadmap** — [roadmap.zdg.com.br](https://roadmap.zdg.com.br/) | Sugerir e votar em funcionalidades | Regra prática: aprenda o básico nas aulas do portal e, quando precisar de algo específico, pesquise aqui na central. O Painel do Licenciado funciona por fora da instalação, então você consegue gerenciar a licença mesmo com o servidor fora do ar. *** #### Os 5 passos até o sistema no ar **Passo 1 — Comece por aqui** É este guia (e a aula 0.1 do portal). Siga as aulas do portal na ordem: elas foram montadas como uma trilha. *** **Passo 2 — Prepare o ambiente** Você vai precisar de: * Uma VPS com no mínimo **4 vCPUs, 16 GB de RAM e 200 GB de SSD**, com **Ubuntu 24.04 LTS sem painel** e arquitetura AMD, de preferência no Brasil. * Dois subdomínios do **tipo A** apontados para o IP da VPS: um para o sistema (ex.: `app.`) e outro para a API (ex.: `api.`). Se usa Cloudflare, deixe a nuvem **cinza** (sem proxy). O passo a passo completo está em: *** **Passo 3 — Instale o Z-PRO** Há dois caminhos: * **Agendar com a nossa equipe:** abra um chamado em [suporte.zdg.com.br](https://suporte.zdg.com.br/) com o assunto **"Agendar instalação"** e envie os dados da VPS e do domínio. O prazo é de **2 a 5 dias úteis** depois que os dados estiverem completos e corretos. * **Instalar você mesmo:** com o instalador automático, disponível no portal. Leva poucos minutos se o ambiente estiver certo. {% hint style="info" %} Se você nunca acessou um servidor por SSH, o agendamento é o caminho mais tranquilo. Nos dois casos a instalação segue o modelo padrão suportado pela ZDG. Instalação em Docker não faz parte do suporte. {% endhint %} *** **Passo 4 — Ative a licença** Após a instalação, o sistema funciona, mas ainda sem licença ativa. Para ativar: 1. Acesse o painel com o usuário **Super Admin**. 2. No menu lateral, vá em **Tenants e Licenciamento → Assinatura**. 3. Insira a **chave de licença** recebida por e-mail. 4. Informe o **domínio principal** da instalação (o mesmo subdomínio do sistema configurado no Passo 2). 5. Salve para concluir a ativação. {% hint style="warning" %} O domínio informado na ativação deve ser **exatamente o mesmo** da instalação. Domínio diferente impede a ativação da licença. {% endhint %} {% hint style="danger" %} Logo após a instalação, **troque as senhas padrão**. O passo a passo está em Manutenção e Segurança. {% endhint %} *** **Passo 5 — Leia as diretrizes da plataforma** Antes de colocar clientes no sistema, leia três páginas: * [Manutenção e Segurança: ações obrigatórias de segurança pós-instalação, firewall e backups](/diretrizes-e-politicas/manutencao-e-seguranca.md) * [Política de Suporte Técnico: canais, horários, prazos e o que está incluso no suporte](/diretrizes-e-politicas/politica-de-suporte-tecnico.md) * [Termos e Condições de Uso e Licenciamento](/diretrizes-e-politicas/termos-e-condicoes-gerais-de-uso-e-licenciamento.md) *** #### Importante: duas datas diferentes | Data | O que é | Quando vence | | ----------------------- | ----------------------------------- | ------------------------------------------------------------------- | | **Validade da licença** | Sua assinatura anual | Você renova a assinatura | | **Validade da versão** | O prazo de vida da versão instalada | O sistema **para**, mesmo com a licença em dia. É preciso atualizar | Na prática: **atualize o Z-PRO pelo menos duas vezes por ano**. O aviso de cada versão nova sai no canal do Telegram. Veja mais em Gerenciar Licença Z-PRO. *** --- # 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://ajuda.zdg.com.br/primeiro-acesso/onboarding-novos-assinantes.md?ask=&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.