- Las variables de entorno permiten parametrizar contenedores para adaptar su comportamiento sin modificar la imagen base.
- Existen múltiples métodos de configuración, desde el Dockerfile y archivos .env hasta el uso de Docker Compose y la CLI.
- La separación de credenciales sensibles mediante archivos externos o secrets es fundamental para mantener la seguridad del despliegue.
¿Cómo editar las variables de entorno de un contenedor desde Dockge? Si te has metido en el mundo de los contenedores, probablemente te hayas dado cuenta de que no quieres estar editando el código o la imagen cada vez que cambias una contraseña o un puerto. Aquí es donde entran en juego las variables de entorno, que básicamente funcionan como etiquetas con valores dinámicos que le dicen a tu aplicación cómo debe comportarse según el sitio donde esté instalada.
Ya sea que estés usando la línea de comandos, archivos YAML o herramientas gráficas como Dockge, saber dónde meter mano para cambiar un parámetro (como el famoso N8N_SECURE_COOKIE en n8n) es vital para que tu servidor no dé errores y funcione como Dios manda en tu red local o en producción.
¿Qué son exactamente estas variables?
Para que no haya pérdida, piensa en una variable de entorno como un valor externo que parametriza el funcionamiento de un proceso. En lugar de escribir «a fuego» (hardcodear) una clave de API o un nombre de base de datos dentro del archivo de configuración, usamos un marcador de posición. Esto hace que el contenedor sea mucho más flexible y portable, ya que la misma imagen puede servir para desarrollo, pruebas o producción, cambiando solo el archivo de variables.
Métodos para definir variables en Docker
- En el Dockerfile: Se utiliza la instrucción
ENV. Esto es ideal para dejar valores predeterminados que se apliquen a cualquier contenedor creado a partir de esa imagen. Por ejemplo, definir que el puerto por defecto sea el 3000. - Usando Docker Compose: En el archivo
docker-compose.yml, puedes usar la secciónenvironment. Es la forma más común cuando gestionas varios servicios a la vez, permitiéndote listar las variables servicio por servicio. - A través de la CLI (Línea de comandos): Si lanzas un contenedor con
docker run, puedes añadir el flag-eo--env. Esto es perfecto para valores transitorios que solo necesitas en una ejecución puntual. - Mediante archivos .env: Docker Compose busca por defecto un archivo llamado
.enven la misma carpeta. Es la opción más limpia porque separa la configuración del archivo YAML, evitando que los secretos queden expuestos si subes el proyecto a GitHub.
Gestión avanzada y seguridad
Cuando manejamos datos delicados, como contraseñas de root de MariaDB o tokens de acceso, no es muy elegante dejarlos en texto plano. Para evitar sustos, existen dos estrategias muy potentes. Primero, el uso de env_file en Compose, que inyecta un archivo entero de variables dentro del contenedor sin ensuciar el YAML. Segundo, la implementación de secrets, donde Docker monta un archivo interno que la aplicación lee, eliminando la necesidad de pasar la clave como una variable de entorno visible.
Si alguna vez te surge la duda de si una variable se ha cargado correctamente, puedes usar el comando docker inspect filtrando por el formato de configuración de entorno, o entrar directamente al contenedor con docker exec y ejecutar el comando env para listar todas las variables activas en ese instante. Seguimos con cómo editar las variables de entorno de un contenedor desde Dockge.
Diferencia entre ARG y ENV
Es muy común confundirlos, pero tienen propósitos distintos. Las instrucciones ARG se utilizan únicamente durante el proceso de construcción (build) de la imagen. Es decir, sirven para pasar parámetros al constructor, pero una vez que la imagen está creada, ese valor desaparece. En cambio, ENV persiste y está disponible durante todo el tiempo de ejecución del contenedor.
Aplicación práctica en herramientas como Dockge
Cuando utilizas interfaces como Dockge, que básicamente es un gestor visual para Docker Compose, la edición de variables es mucho más intuitiva. Para resolver problemas como el acceso a n8n en LAN, debes buscar el apartado de edición del stack o contenedor. Allí encontrarás la lista de comandos de entorno donde simplemente debes añadir o modificar la clave deseada (por ejemplo, poner N8N_SECURE_COOKIE=false) y actualizar un contenedor Docker usando Dockge para que los cambios surtan efecto.
Para mantener el orden, lo más recomendable es crear siempre un archivo .env.example con valores ficticios. Así, cualquier persona que descargue tu proyecto sabrá qué variables necesita configurar sin que tú tengas que compartir tus claves reales, bastando con que hagan una copia del ejemplo y la renombren a .env.
Dominar la inyección de parámetros a través de Dockerfiles, archivos de entorno y comandos de ejecución permite crear infraestructuras escalables y seguras, facilitando la transición entre diferentes entornos de trabajo y protegiendo la información sensible mediante la correcta segregación de datos y el uso de herramientas de gestión visual o CLI. Ahora ya sabes cómo editar las variables de entorno de un contenedor desde Dockge.
Apasionado de la tecnología desde pequeñito. Me encanta estar a la última en el sector y sobre todo, comunicarlo. Por eso me dedico a la comunicación en webs de tecnología y videojuegos desde hace ya muchos años. Podrás encontrarme escribiendo sobre Android, Windows, MacOS, iOS, Nintendo o cualquier otro tema relacionado que se te pase por la cabeza.