Consultar la versión y la clave secreta de Seq en Docker

Seq incluye herramientas de línea de comandos para consultar su versión y realizar tareas administrativas. En una instalación Docker, algunos comandos se ejecutan dentro del contenedor. Entre ellos está show-key, que imprime la clave secreta de la instancia: esta clave protege información sensible de la configuración y las copias de seguridad, así que su salida debe tratarse como un secreto [1].

Esta guía explica cómo consultar la ayuda y la versión de un contenedor y cómo recuperar la clave de una instancia existente sin copiarla a documentación, chats o registros compartidos.

Consultar la ayuda desde el contenedor

Abre una shell en el contenedor en ejecución. Sustituye seq por el nombre o ID real del contenedor:

docker exec -it seq /bin/bash

Dentro del contenedor, consulta la ayuda general y la de un comando concreto:

seqsvr help
seqsvr help show-key

La línea de comandos del servidor incluye help para enumerar los comandos disponibles y mostrar sus opciones [2]. Si el nombre del ejecutable difiere en tu versión, consulta la ayuda de esa imagen concreta antes de ejecutar una operación administrativa.

Consultar la versión instalada

Dentro de la shell del contenedor, ejecuta:

seqsvr version

El comando muestra la versión del servidor que contiene esa imagen. Anota el resultado para inventario o diagnóstico, pero evita usar una versión de imagen distinta cuando ejecutes herramientas contra el directorio de datos de una instancia existente [2][3].

Para salir de la shell, ejecuta exit.

Recuperar la clave secreta de una instancia existente

show-key imprime la clave de cifrado de Seq. No es una API key: Seq no almacena las contraseñas de usuario ni las API keys como secretos reversibles. La clave secreta protege otros datos, como contraseñas de integraciones y copias de seguridad [1].

La clave de una instancia configurada es fija y no debe sustituirse por otra. Si se pierde, recuperar acceso a los datos protegidos y a ciertas copias puede verse afectado. Guárdala en un gestor de secretos con acceso restringido y mantenla junto a la documentación de recuperación, nunca dentro de un post, un repositorio o una transcripción pública [1].

Para ejecutar el comando desde un contenedor auxiliar, detén primero la instancia que usa el volumen de datos y asegúrate de que no haya otro contenedor conectado a ese volumen. Datalust advierte que dos contenedores no deben acceder simultáneamente al mismo almacenamiento [3][4]. Después, monta el directorio persistente de la instancia en /data y usa la misma versión de imagen que ejecuta Seq:

docker stop seq

docker run --rm -it \
  -e ACCEPT_EULA=Y \
  -v /ruta/persistente/de/seq:/data \
  datalust/seq:<VERSION> \
  show-key --storage=/data

Sustituye /ruta/persistente/de/seq por el directorio o volumen persistente real y <VERSION> por la etiqueta de imagen de la instancia. El valor de la clave aparecerá en la terminal: no lo copies en el artículo ni lo compartas en capturas o registros. Una vez guardado de forma segura, vuelve a iniciar Seq:

docker start seq

Si solo necesitas consultar help o version, no hace falta montar el directorio de datos en un segundo contenedor. La advertencia de detener la instancia aplica al comando auxiliar que comparte su almacenamiento persistente [3][4].

No regenerar la clave de una instancia existente

La opción show-key --generate sirve para generar una clave nueva antes de configurar otra instancia. No la uses para reemplazar la clave de una instancia ya configurada: la documentación de Seq indica que su clave secreta queda fijada y no debe cambiarse después de la configuración inicial [1].

Resumen

• Consulta ayuda y versión desde el contenedor que ejecuta Seq.
• show-key revela la clave secreta de cifrado de Seq; no es una API key [1].
• Guarda la clave en un gestor de secretos y junto al procedimiento de recuperación.
• Si un contenedor auxiliar comparte el volumen /data, detén primero la instancia principal y usa la misma versión de imagen [1][3][4].
• No regeneres ni sustituyas la clave de una instancia configurada [1].

📚 Fuentes consultadas

1. The Secret Key — Seq documentation
2. Server Command Line — Seq documentation
3. Running Server Commands — Seq documentation
4. Storage — Seq Docker documentation

Imagen