> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/configuration/dockered-configuration/env-file.md). # .env Configure o Navixy em Docker usando o arquivo .env. Defina credenciais do banco de dados, nomes de domínio, caminhos dos certificados SSL, opções do Let's Encrypt e parâmetros do MySQL. Para executar a versão em Docker da plataforma Navixy, o **.env** arquivo é o arquivo de configuração principal. Ele contém parâmetros importantes como credenciais do banco de dados, nomes de domínio, a pasta de trabalho de instalação da plataforma e outros. ![](https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-d990eb7ccbe679666d60506ffeaa357815158267%2Fimage-20230907-140128.png?alt=media) O **.env** O arquivo é usado principalmente durante a instalação inicial da plataforma. No entanto, se você precisar alterar algo na configuração de uma plataforma existente, também precisará modificar este arquivo. Todos os parâmetros neste arquivo estão comentados para facilitar a compreensão do que você está lidando. Informações adicionais sobre esses parâmetros são descritas nas seções abaixo. {% hint style="info" %} Se você alterar alguma configuração enquanto a instância já estiver em execução, as alterações não serão aplicadas instantaneamente. Você precisa reinicializar toda a instância para que elas entrem em vigor. Para fazer isso, a partir da pasta principal da plataforma (navixy-package), execute o comando: `docker compose up -d` Isso recriará os contêineres com as novas configurações. {% endhint %} ## UID e GID Estes são parâmetros de serviço usados apenas na etapa de compilação da plataforma. Você não precisa alterá-los. ## WORKDIR Este é um parâmetro que indica o diretório de trabalho da plataforma — onde o banco de dados e todos os arquivos de serviço são armazenados. É necessário proteger este diretório para evitar a perda de dados de negócios. Valor padrão deste parâmetro: `WORKDIR=./work`. Isso significa que `/work` o diretório dentro da compilação descompactada do Navixy é usado. Se o diretório não existir, ele será criado. Se necessário, você pode colocar o diretório de trabalho em qualquer lugar do seu sistema. Para fazer isso, especifique o caminho completo para o diretório. Exemplos: * `/home/admin/work` * `/usr/local/navixy` Certifique-se de dar ao diretório um nome óbvio para não excluí-lo por engano. ## navixy\_username Este é o nome de usuário usado para acesso ao banco de dados. Ele sempre é `navixy`, não o altere. ## navixy\_passwd Esta é a senha do `navixy` usuário do banco de dados. Por padrão, esse valor está vazio e você precisa especificar a senha de sua preferência. Recomenda-se gerar automaticamente uma senha forte, mas a escolha é sua; você pode especificar o que quiser. Não altere essa senha após o banco de dados ser criado e a plataforma implantada. ## service\_domain Este é o domínio principal da sua instância da plataforma. Ele é usado para: * Acesso à interface do usuário. * Ativar novo rastreador. Caso você esteja utilizando uma instalação de domínio único (sem domínios separados para API e painel administrativo), este domínio também será usado para: * Acesso à API pelo link `service_domain/api` * Acesso ao painel administrativo pelo link `service_domain/panel` {% hint style="info" %} Isso também pode ser o endereço IP do seu servidor, se você não for usar um nome de domínio para o seu serviço. {% endhint %} ## api\_domain Este parâmetro é opcional e usado apenas para instalações de três domínios. Aqui você precisa especificar o nome de domínio usado para acessar a API da sua plataforma. ## panel\_domain Este também é um parâmetro opcional usado para instalações de três domínios. Aqui você precisa especificar o nome de domínio usado para acessar o painel administrativo da sua plataforma. ## le\_enabled Este parâmetro ativa a emissão automática e a posterior reemissão do certificado SSL do Let's Encrypt. Ele é `true` por padrão. Isso significa que, quando você implantar a plataforma, o Certbot será configurado e lidará com a emissão automática do certificado SSL para os seus domínios. Dessa forma, você não precisará se preocupar em comprar certificados de terceiros. A instância se configurará para ficar protegida por SSL. Se você quiser usar seu próprio certificado SSL em vez do Let's Encrypt, altere este parâmetro para `false`. ## le\_email Este é o endereço de e-mail para receber informações sobre a operação do Certbot, como expiração do certificado, revogação do certificado e problemas que podem levar à impossibilidade de reemitir o certificado. Por padrão, este parâmetro está vazio. Recomenda-se que você especifique um endereço de e-mail válido para não perder notificações importantes sobre a proteção SSL do seu site. ## redirect\_to\_https Esta configuração permite que as solicitações sejam redirecionadas de *http* para *https*. Se a sua plataforma estiver configurada para usar proteção SSL e alguém tentar usar uma URL que comece com *http*, um redirecionamento automático para *https* será acionado. Se o parâmetro estiver desativado (false), então nenhum redirecionamento ocorrerá, e o site não será aberto. {% hint style="info" %} Este parâmetro se aplica apenas se a proteção SSL estiver ativada e o certificado SSL estiver instalado. {% endhint %} ## service\_ssl\_cert e service\_ssl\_key Se você não pretende usar o Let's Encrypt e quiser usar seu próprio certificado SSL em vez disso, você precisa colocar o certificado do seu domínio e sua chave privada no diretório: `WORKDIR/nginx/ssl`. {% hint style="danger" %} Certifique-se de mudar **le\_enabled** o parâmetro para `false` antes de aplicar quaisquer alterações a esta seção. Você não pode usar seus próprios certificados para a plataforma quando o certbot estiver em execução. {% endhint %} Depois que o certificado e a chave estiverem no lugar, você precisa especificar seus nomes de arquivo para os parâmetros correspondentes da configuração. Observe que você não precisa especificar caminhos. Exemplo: ``` service_ssl_cert=my_domain_com.crt service_ssl_key=my_domain_com.key ``` ## MYSQL\_RANDOM\_ROOT\_PASSWORD Este parâmetro habilita a geração de senha aleatória para o MySQL `root` usuário. O valor padrão é `true`. O parâmetro é usado apenas na inicialização do banco de dados ao instalar a plataforma. Em reinicializações e atualizações posteriores da plataforma, ele não faz nada, e a senha permanece a mesma. Se você preferir definir uma senha específica de root do MySQL, altere o valor para `false` e prossiga para o próximo parâmetro. ## MYSQL\_ROOT\_PASSWORD Aqui você especifica a senha de root do MySQL. Este parâmetro é aplicado apenas quando `MYSQL_RANDOM_ROOT_PASSWORD` é alternado para `false`. Caso contrário, o valor é ignorado. ## skip\_db\_update Este parâmetro desativa a atualização do banco de dados quando `navixy-standalone-db` o contêiner é iniciado. Ele é usado para fins de teste; você não precisa alterar o valor padrão (`false`) durante o uso normal da plataforma. --- # 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://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/configuration/dockered-configuration/env-file.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.