El asistente y la licencia
La primera visita a /admin, el código de configuración y la activación de la licencia.
La primera vez que abres /admin (por ejemplo https://nube.example.com/admin), KumoYami muestra un asistente de
configuración. Solo aparece mientras no haya contraseña de administrador.
El código de configuración
Para que nadie más pueda configurar tu web antes que tú, el asistente pide un código que KumoYami escribe en los registros del servidor al arrancar. El instalador lo muestra al terminar; si no lo tienes a mano, en la carpeta de la instalación:
docker compose logs web | grep -i códigoEn un NAS, búscalo en los registros (logs) del contenedor: es la línea del «Código de configuración inicial». Con el
paquete nativo de Synology, está en File Station → la carpeta compartida de los datos → logs → kumoyami.log.
Los pasos del asistente
Escribe el código
El de los registros del servidor.
Elige la contraseña del panel y el nombre de la web
La contraseña protege /admin; usa una larga. El nombre es el que se ve en la pestaña del navegador y en la barra
superior, y se puede cambiar después en Apariencia.
Activa la licencia
Pega la clave de tu licencia (KY1.…). KumoYami la activa contra licenses.kumoyami.com y la deja asociada a esta
instalación.
Con ADMIN_PASSWORD en el .env no hay asistente
Si pusiste ADMIN_PASSWORD en el .env, entra directamente con ella: no se pide código. Mientras no haya licencia, el
panel abre solo la página Licencia, donde pegas la clave. ADMIN_PASSWORD manda sobre la contraseña elegida en
el panel.
Cómo funciona la licencia
- Se renueva sola cada hora, con una conexión de salida a
https://licenses.kumoyami.com. El servidor de licencias recibe solo el identificador de la instalación, su versión y su dominio. - Sin conexión, sigue valiendo 30 días. Si dejara de valer, la web se detiene y el panel solo muestra cómo volver a vincular el servidor. No se borra nada.
- Tu plan (Gratis, Pass, Pro o Total) decide qué funciones tiene el panel. La página Licencia muestra lo que incluye; lo que no, aparece con la etiqueta del plan que lo trae.
- Las actualizaciones: todos los planes reciben todas las versiones, también Gratis, sin nada que renovar. Si dejas de pagar una suscripción, tu web sigue funcionando con el plan Gratis y sigue actualizándose. Mira Actualizar.
- Una clave nueva (por ejemplo, si te mandamos otra al cambiar de plan) se pega en Licencia → Sustituir la clave.
Acceso al panel
En la pestaña Cuenta del panel puedes cambiar la contraseña, activar un segundo paso con una app de autenticación (con códigos de recuperación), añadir passkeys y cerrar las demás sesiones. Las passkeys solo funcionan en el dominio donde se crean.
- ¿Olvidaste la contraseña? Pon una en
ADMIN_PASSWORDen el.envy ejecutadocker compose up -d: manda sobre la del panel. - ¿Perdiste el segundo paso (sin móvil ni códigos de recuperación)? Añade
KUMOYAMI_RESET_2FA=1al.envy ejecutadocker compose up -d. Al arrancar se borran la app de autenticación, los códigos y las passkeys, se cierran las sesiones y queda anotado en el registro de actividad. Después, quita la variable y vuelve a ejecutardocker compose up -d.
Siguientes pasos
Todas las marcas y logotipos pertenecen a sus respectivos propietarios. Su uso solo indica compatibilidad, no patrocinio ni asociación. El logotipo de Synology es una marca de Synology Inc.; Google Drive, Google Cast y Android son marcas de Google LLC, y el robot de Android es obra de Google, compartida con la licencia Creative Commons Reconocimiento 3.0. Microsoft, Windows y OneDrive son marcas de Microsoft; Amazon S3, de Amazon.com, Inc. o sus filiales; Apple, AirPlay, macOS e iPhone, de Apple Inc.; Raspberry Pi, de Raspberry Pi Ltd; Ubuntu, de Canonical Ltd.; Debian, de Software in the Public Interest, Inc.; Linux, de Linus Torvalds. Este producto usa la API de TMDB, pero TMDB no lo respalda ni certifica.