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».
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 licencias.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 día, con una conexión de salida a
https://licencias.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 14 días. Si dejara de valer, se bloquea el panel de administración, nunca la web pública: tus visitantes no notan nada.
- Tu plan (Personal, Pro o Business) 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 que incluye tu licencia son las versiones publicadas hasta el final de su periodo de actualizaciones. Al terminar, tu web sigue funcionando con su versión. Mira Actualizar.
- Una clave nueva (por ejemplo, al ampliar las actualizaciones o cambiar de plan) se pega en Licencia →
Sustituir la clave. Repite también el
docker logincon ella.
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.