> 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/es/on-premise/how-to-guide/configuration/dockered-configuration/env-file.md). # Archivo .env Configure Navixy en Docker mediante el archivo .env. Establezca credenciales de base de datos, nombres de dominio, rutas de certificados SSL, opciones de Let's Encrypt y parámetros de MySQL. Para ejecutar la versión dockerizada de la plataforma Navixy, el **.env** archivo es el archivo principal de configuración. Contiene parámetros tan importantes como las credenciales de la base de datos, los nombres de dominio, la carpeta de trabajo de instalación de la plataforma y otros. ![](https://699359129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-d990eb7ccbe679666d60506ffeaa357815158267%2Fimage-20230907-140128.png?alt=media) El **.env** archivo se usa principalmente durante la instalación inicial de la plataforma. Sin embargo, si necesita cambiar algo en la configuración de una plataforma existente, también tendrá que modificar este archivo. Todos los parámetros de este archivo están comentados para que comprenda mejor con qué está trabajando. La información adicional sobre estos parámetros se describe en las secciones siguientes. {% hint style="info" %} Si cambia alguna configuración mientras la instancia ya está en ejecución, los cambios no se aplican de inmediato. Debe reinicializar toda la instancia para que surtan efecto. Para hacerlo, desde la carpeta principal de la plataforma (navixy-package), ejecute el comando: `docker compose up -d` Esto volverá a crear los contenedores con la nueva configuración. {% endhint %} ## UID y GID Estos son solo parámetros de servicio que se usan en la etapa de compilación de la plataforma. No necesita cambiarlos. ## WORKDIR Este es un parámetro que indica el directorio de trabajo de la plataforma, donde se almacenan la base de datos y todos los archivos del servicio. Es necesario proteger este directorio para evitar la pérdida de datos de negocio. Valor predeterminado de este parámetro: `WORKDIR=./work`. Esto significa que `/work` se usa el directorio dentro de la compilación desempaquetada de Navixy. Si el directorio no existe, se creará. Si es necesario, puede colocar el directorio de trabajo en cualquier lugar de su sistema. Para hacerlo, especifique la ruta completa al directorio. Ejemplos: * `/home/admin/work` * `/usr/local/navixy` Asegúrese de darle al directorio un nombre obvio para no eliminarlo por accidente. ## navixy\_username Este es el nombre de usuario que se usa para acceder a la base de datos. Siempre es `navixy`, no lo cambie. ## navixy\_passwd Esta es la contraseña para `navixy` el usuario de la base de datos. Por defecto, este valor está vacío y debe especificar la contraseña de su elección. Se recomienda generar automáticamente una contraseña segura, pero la elección es suya; puede especificar la que quiera. No cambie esta contraseña después de que se cree la base de datos y se implemente la plataforma. ## service\_domain Este es el dominio principal de la instancia de su plataforma. Se usa para: * Acceso a la interfaz de usuario. * Activar dispositivo. En caso de que esté utilizando una instalación de un solo dominio (sin dominios separados para API y panel de administración), este dominio también se usará para: * Acceso a la API mediante el enlace `service_domain/api` * Acceso al panel de administración mediante el enlace `service_domain/panel` {% hint style="info" %} También puede ser la dirección IP de su servidor si no va a usar un nombre de dominio para su servicio. {% endhint %} ## api\_domain Este parámetro es opcional y se usa solo para instalaciones de tres dominios. Aquí debe especificar el nombre de dominio que se usa para acceder a la API de su plataforma. ## panel\_domain Este también es un parámetro opcional que se usa para instalaciones de tres dominios. Aquí debe especificar el nombre de dominio que se usa para acceder al panel de administración de su plataforma. ## le\_enabled Este parámetro activa la emisión automática y la posterior renovación del certificado SSL de Let's Encrypt. Es `true` por defecto. Esto significa que, cuando implemente la plataforma, Certbot se configurará y se encargará de la emisión automática de certificados SSL para sus dominios. Así, no tendrá que preocuparse por comprar certificados de terceros. La instancia se configurará para estar protegida con SSL. Si desea usar su propio certificado SSL en lugar de Let's Encrypt, cambie este parámetro a `false`. ## le\_email Esta es la dirección de correo electrónico para recibir información sobre el funcionamiento de Certbot, como el vencimiento del certificado, la revocación del certificado y los problemas que pueden impedir la renovación del certificado. Por defecto, este parámetro está vacío. Se recomienda que especifique una dirección de correo electrónico válida para no perder notificaciones importantes sobre la protección SSL de su sitio web. ## redirect\_to\_https Esta configuración permite redirigir las solicitudes de *http* a *https*. Si su plataforma está configurada para usar protección SSL y alguien intenta usar una URL que comience con *http*, una redirección automática a *https* se activará. Si el parámetro está desactivado (false), no ocurrirá ninguna redirección y el sitio web no se abrirá. {% hint style="info" %} Este parámetro solo es aplicable si la protección SSL está activada y el certificado SSL está instalado. {% endhint %} ## service\_ssl\_cert and service\_ssl\_key Si no piensa usar Let's Encrypt y desea usar su propio certificado SSL en su lugar, debe colocar el certificado para su dominio y su clave privada en el directorio: `WORKDIR/nginx/ssl`. {% hint style="danger" %} Asegúrese de cambiar **le\_enabled** el parámetro a `false` antes de aplicar cualquier cambio en esta sección. No puede usar sus propios certificados para la plataforma cuando certbot está en ejecución. {% endhint %} Después de que el certificado y la clave estén en su lugar, debe especificar sus nombres de archivo para los parámetros correspondientes de la configuración. Tenga en cuenta que no necesita especificar rutas. Ejemplo: ``` service_ssl_cert=my_domain_com.crt service_ssl_key=my_domain_com.key ``` ## MYSQL\_RANDOM\_ROOT\_PASSWORD Este parámetro permite generar una contraseña aleatoria para MySQL `root` usuario. El valor predeterminado es `true`. El parámetro se usa solo durante la inicialización inicial de la base de datos al instalar la plataforma. En reinicios y actualizaciones posteriores de la plataforma no hace nada, y la contraseña permanece igual. Si prefiere establecer una contraseña específica para el usuario root de MySQL, cambie el valor a `false` y pase al siguiente parámetro. ## MYSQL\_ROOT\_PASSWORD Aquí especifica la contraseña del usuario root de MySQL. Este parámetro se aplica solo cuando `MYSQL_RANDOM_ROOT_PASSWORD` se establece en `false`. De lo contrario, el valor se ignora. ## skip\_db\_update Este parámetro desactiva la actualización de la base de datos cuando `navixy-standalone-db` contenedor se inicia. Se usa con fines de prueba; no necesita cambiar el valor predeterminado (`false`) durante el uso normal de la 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/es/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.