# Instalação fácil

Este guia ajudará você a configurar rapidamente a plataforma Navixy On-premise em seu próprio servidor. O processo é simples e requer configuração manual mínima.

Antes de começar, verifique a [Requisitos](https://www.navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/requirements) seção e certifique-se de que seu servidor e infraestrutura estão prontos para implantar a plataforma Navixy.

{% hint style="info" %}
Este tipo de implantação utiliza Docker como meio principal de implantação. No entanto, o processo é totalmente automatizado, então você não precisa ser proficiente neste software, apenas ter conhecimentos básicos de administração Linux.
{% endhint %}

Este guia o conduzirá pelo processo passo a passo de instalação da solução Navixy Easy em um servidor Linux. Embora recomendemos fortemente o Ubuntu por sua operação e administração amigáveis, fique tranquilo: qualquer distribuição Linux atualizada é adequada para a instalação. Sinta-se à vontade para escolher a que melhor atender às suas necessidades.

Observe que a instalação requer privilégios elevados. Nas instruções fornecidas abaixo, a instalação é demonstrada usando o `root` usuário. Como alternativa, você também pode realizar a instalação usando o `sudo` comando.

## Passo 1 - Instalar Docker e baixar a build Navixy

Para preparar a implantação da plataforma Navixy, você pode seguir estes comandos.

O comando inicial fará o download do script de instalação da plataforma Navixy On-premise para o seu servidor. O comando subsequente executará esse script, que instalará o Docker e buscará a versão mais atual do pacote de distribuição da plataforma.

```
curl -fsSL https://get.navixy.com -o install-navixy.sh
sh ./install-navixy.sh
```

{% hint style="info" %}
O script verifica se o Docker está instalado no servidor. Se o Docker for detectado, o script exibirá uma mensagem sobre isso e fará uma pausa. Isso é feito para evitar implantações inadvertidas em servidores onde o Navixy já está instalado. Se o Docker instalado não estiver relacionado ao Navixy, apenas aguarde um pouco e o script continuará sua execução.
{% endhint %}

Você verá o processo de instalação do Docker, após o qual o pacote de distribuição da plataforma será descompactado.

![On-Premise - instalação com Docker](https://645322942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-ac01806097f35001883ce3643998343446b7dcc2%2Fnewdocker.gif?alt=media)

Após o script concluir seu trabalho, ele informará o sucesso e exibirá um link levando à página atual.

Em seguida, você precisará especificar a chave de licença e as configurações necessárias, e então implantar a plataforma conforme descrito na próxima seção.

## Passo 2 - Implantar a plataforma Navixy

Nosso script de configuração torna esta etapa sem esforço.

Abra o recém-criado *“navixy-package”* diretório e execute o `easy-configure.sh` script:

```
cd ./navixy-package
./docker-configure.sh
```

O script executará um assistente onde você precisará especificar os parâmetros necessários da sua nova instância Navixy On-premise:

![](https://645322942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-c9c39482c021bb85a151c6b30d98312534a4963f%2Fimage-20250306-184855.png?alt=media)

* **Fingerprint** - chave de licença. Conjunto único de caracteres recebido da equipe técnica da Navixy. Pode ser usado apenas uma vez.
* **Database Password** - uma senha para o usuário do banco de dados. Você pode criar qualquer senha de sua escolha ou gerá-la automaticamente com alguma ferramenta de terceiros.
* **Service Domain**- domínio básico da sua plataforma. Será usado para acessar contas de usuário e para registrar hardware de rastreamento.
* **API Domain** - domínio do serviço de API (**opcional** - não exigido para instalações com um único domínio).
* **Panel Domain** - domínio do painel do administrador (**opcional** - não exigido para instalações com um único domínio).
* **Working directory** - diretório de serviço usado para armazenar arquivos de configuração, arquivos de log e outros arquivos do sistema.
  * O diretório padrão é `.../navixy-package/work/` (dentro do distributivo Navixy descompactado). Se não for alterado, a plataforma será instalada nesse diretório.

{% hint style="info" %}
Se nomes de domínio opcionais para API e painel não forem especificados, esses serviços ficarão acessíveis como subdiretórios do domínio de serviço, por exemplo:

* `domain.com/api`
* `domain.com/panel`
  {% endhint %}

Após especificar todos os parâmetros, será solicitado que você escolha se deseja habilitar HTTPS para tornar seu site protegido por SSL, ou se não precisa dessa opção.

![](https://645322942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-4614589a7932ce26faf7227f07e9a5566456065b%2Fimage-20250306-191609.png?alt=media)

Se você responder Sim, será solicitado que escolha entre instalar um certificado gratuito Let's Encrypt ou seu próprio certificado SSL de uma autoridade terceira. Selecione a opção desejada e siga as instruções do instalador.

![](https://645322942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-c40f9d448ac1e74fe068633d570988a0dc1cac1a%2Fimage-20250306-191842.png?alt=media)

Depois que todas as configurações forem feitas, você verá o resumo da configuração

![](https://645322942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-e8a5d6d74e3aa4a616f02cff9fa4807012931931%2Fimage-20250306-192813.png?alt=media)

Confirme as configurações e o script implantarà a plataforma Navixy On-premise com seus parâmetros. Em pouco tempo, a plataforma será instalada, iniciada e totalmente pronta para uso.

## Passo 3 - Verificar o funcionamento da plataforma

Abra seu navegador web e navegue até o painel de administração. O link de acesso dependerá dos parâmetros que você especificou durante a instalação. Será um dos seguintes:

* Domínio do painel (por exemplo `panel.domain.com`)
* Subdiretório do domínio de serviço (por exemplo `domain.com/panel`)

O login e a senha padrão são `admin`.

![On-Premise - instalação com Docker - Verificando a plataforma](https://645322942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-de3f06c35c8c641dd18b1a51beae83a457d9be2b%2Fchrome_VFgPhAehZp.gif?alt=media)

Se você fez login com sucesso na plataforma, altere sua senha de administrador em *Preferências de serviço* menu.

**O processo de instalação está agora concluído.**

Se você precisar de mais orientações sobre o uso e a configuração da plataforma, ou se encontrar quaisquer problemas técnicos, não hesite em pedir assistência entrando em contato com [Navixy technical support](mailto:support@navixy.com).
