# 2. Instalação automática

### [Link para aula completa - portal do assinante](https://portal.zdg.com.br/270021-sistema-zpro/5179464-instalacao-automatica-z-pro-pacote-ultima-versao)

### Pré-requisitos para instalação

* **Ambiente Pronto:** Garanta que você já concluiu a **Aula 1**, com o servidor VPS contratado e os dois subdomínios (front-end e back-end) apontados para o IP correto.
* **Instalador Baixado:** Faça o download do pacote do instalador (`zpro_passaporte_shell.zip`) disponível nessa aula e descompacte o arquivo em seu computador.

### Passo 1: Conexão com o Servidor (via SSH)

Para interagir com o servidor, você precisará de um cliente SSH.

* **Ação:** Use um programa como o **Bitvise** (para Windows) ou o terminal para conectar.
* **Dados para Conexão:**
  * **Host:** O IP da sua VPS.
  * **Porta:** `22`
  * **Usuário:** `root`
  * **Senha:** A senha de `root` que você definiu ao criar a VPS.

### Passo 2: Atualização Inicial do Servidor

Antes de instalar, é uma boa prática atualizar os pacotes do sistema operacional.

* **Ação:** Após conectar, execute o comando abaixo e aguarde a conclusão.
  * `apt update && apt upgrade -y`
* Em seguida, reinicie o servidor para aplicar as atualizações:
  * `reboot`
* Aguarde e reconecte-se ao servidor via SSH.

### Passo 3: Upload do Instalador

* **Ação:** Use o SFTP (disponível no Bitvise ou outro cliente) para enviar a pasta descompactada (`zpro_passaporte_shell`) para o diretório `/root` do seu servidor.

### Passo 4: Execução do Instalador

Agora vamos rodar o script de instalação.

* **Ação:** No seu terminal SSH, execute os seguintes comandos em ordem:
  1. `cd ~`
  2. `sudo chmod +x ./zpro_passaporte_shell/zpro` (Torna o arquivo executável).
  3. `cd ./zpro_passaporte_shell` (Entra na pasta do instalador).
  4. `sudo ./zpro` (Executa o instalador).

### Passo 5: Iniciar a Instalação no Menu

O último comando abrirá um menu interativo no terminal.

* **Ação:** Pressione a tecla `1` e `Enter` para selecionar **“Instalar instância primária”**.
* **Informe os dados solicitados:**
  * Seu e-mail.
  * Seu subdomínio do front-end (ex: `app.seudominio.com.br`).
  * Seu subdomínio do back-end (ex: `api.seudominio.com.br`).

### Passo 6: Ações de Segurança Pós-Instalação (Obrigatório)

Ao final do processo, o sistema estará instalado, mas você deve realizar ações de segurança.

* **Ação:** Utilize os dados de acesso fornecidos ao final da instalação para alterar todas as senhas padrão e segredos.

**Atenção: A segurança do seu ambiente é sua responsabilidade.**

* **Configure Backups:** Ative uma rotina de backups periódicos no seu servidor.
* Crie uma rotina de segurança, a cada 6 meses, alteres esses dados


---

# Agent Instructions: 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:

```
GET https://ajuda.zdg.com.br/primeiro-acesso/instalar-z-pro/2.-instalacao-automatica.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.