Sitios web
Instalación de una aplicación en tu sitio
The Apps install wizard takes three steps: configure the admin account and site settings, review what is about to happen, then watch the install run and collect your login details.
El asistente de instalación de Apps toma tres pasos: configurar la cuenta de administrador y los parámetros del sitio, revisar lo que está a punto de suceder, y luego ver cómo se ejecuta la instalación y recopilar los detalles de inicio de sesión.
Antes de Empezar
Necesitas una cosa: un sitio web activo en tu cuenta. El asistente instala en un sitio que ya tienes, no crea uno. Si no tienes ninguno, el asistente te lo dice y te vincula para crear uno. Consulta Crear Tu Primer Sitio Web.
También necesitas el permiso apps:write, que tienen los Propietarios de Cuenta y Administradores.
Haz una copia de seguridad antes de instalar en un sitio que ya tiene contenido. El asistente tiene una red de seguridad para un sitio que ya contiene una app, descrita más abajo, pero un punto de restauración manual tomado deliberadamente siempre vale más que uno tomado automáticamente. Consulta Hacer una Copia de Seguridad.
Acceder al Asistente
- Haz clic en Apps en la barra lateral de KPanel.
- Haz clic en la app que quieres.
- Haz clic en Instalar [app] en el panel de la derecha.
La dirección directa es /apps/<app-slug>/install.
Paso 1: Configurar
El asistente muestra la app, luego cuatro grupos de campos. Un aviso de Plan upgrade recomendado aparece en la parte superior si la app sugiere un nivel de plan más alto que el que tienes actualmente: es un consejo, y la instalación aún procede.
Ubicación
Instalar en sitio. Elige entre tus sitios activos. Aquí es donde vivirá la app.
Cuenta de Administrador
- Nombre de usuario de administrador. Por defecto es
admin. Este es el nombre de usuario con el que iniciarás sesión, y puedes añadir más usuarios después. - Contraseña de administrador. Se genera una contraseña fuerte de 16 caracteres para ti en el momento en que se carga la página. Mostrar la revela y Generar crea una nueva. También puedes escribir la tuya; debe tener al menos 8 caracteres.
- Correo electrónico de administrador. Opcional. Se utiliza para el inicio de sesión y el restablecimiento de contraseña. Si se deja en blanco, se utiliza tu correo electrónico de cuenta.
Guarda la contraseña de administrador antes de salir del asistente. Se muestra en la pantalla de revisión y nuevamente en la pantalla de éxito, y luego desaparece. Kapsule no almacena una copia que puedas recuperar después, así que perderla significa restablecer la contraseña a través de la app misma.
Parámetros del Sitio
- Nombre del sitio, donde la app lo solicite.
- Idioma. El idioma en el que se configura la app, elegido entre dieciséis opciones que incluyen inglés (Estados Unidos), inglés (Reino Unido), Te Reo Māori, y los principales idiomas europeos y asiáticos. Esto configura el idioma del contenido de la app, no el de KPanel.
Base de Datos
Se muestra solo para apps que la necesiten. El asistente sugiere un nombre de base de datos derivado de tu dominio. Solo letras y números, sin guiones bajos o guiones: el campo lo refuerza según escribes. Cámbialo si quieres.
Las apps que necesitan una base de datos la tienen aprovisionada automáticamente como parte de la instalación.
Algunas apps añaden sus propios campos adicionales debajo de este, definidos por la app misma, con texto de ayuda donde corresponde. Los campos obligatorios están marcados con un asterisco, y Continuar permanece deshabilitado hasta que todos ellos estén rellenados.
En la parte inferior, el asistente muestra el resumen de recursos para esta app: tiempo de instalación esperado, RAM mínima, y si se añade una base de datos.
Haz clic en Continuar.
Paso 2: Revisar y Confirmar
La pantalla de revisión reafirma las decisiones en una lista: app, sitio web, nombre del sitio, nombre de usuario de administrador, contraseña de administrador (con un botón para mostrar u ocultar), correo electrónico de administrador, idioma y nombre de base de datos. El subtítulo lo dice claramente: nada se instala hasta que confirmes.
- Editar vuelve atrás para cambiar algo.
- Confirmar e instalar inicia el trabajo.
Usa la pantalla de revisión para la comprobación que más importa: la fila Sitio Web. Instalar en el sitio equivocado es el error de instalación más común, y es para el que existe la protección contra sobrescritura que se describe a continuación.
Paso 3: Instalar
El asistente cambia a una vista de progreso. Verás, en orden:
- En cola: esperando a trabajador. Tu trabajo está en la cola y comenzará en breve.
- Instalando [app], con segundos transcurridos en comparación con el tiempo de instalación típico y una barra de progreso.
Deja la página abierta. La instalación continúa en segundo plano si te vas, pero pierdes la vista en vivo y el resumen de credenciales al final.
Si la instalación encuentra un problema, reinténtalo automáticamente, mostrando Reintentando la instalación con el número de intento. Si se ejecuta mucho más allá del tiempo esperado, aparece una nota ofreciendo seguir esperando o cancelar.
Cancelar
Cancelar instalación detiene el trabajo. La pantalla de resultados lo confirma: La instalación fue detenida. Nada fue cambiado en tu sitio.
Cuando el Sitio Ya Tiene una App
Si el directorio del sitio de destino ya contiene un sitio, la instalación se detiene con una advertencia que nombra lo que encontró:
Este directorio ya contiene [app]. Instalar [nueva app] lo SOBRESCRIBIRÁ y no se puede deshacer. Se tomará una copia de seguridad completa de tu sitio actual primero para que puedas restaurarlo.
Dos opciones: cancelar, o Hacer copia de seguridad y sobrescribir. Si consientes, el trabajo toma una copia de seguridad completa del sitio existente antes de escribir algo, así que hay un punto de restauración.
Este es el punto de no retorno en el asistente. Sobrescribir reemplaza los archivos del sitio existente. La copia de seguridad automática significa que es recuperable, no que es reversible con un clic. Si no estás seguro de que el sitio es desechable, cancela e instala en un sitio diferente en su lugar.
Apps Que Nuestro Equipo Instala a Mano
Algunas apps no tienen un instalador automático probado. Para estas, el asistente omite la barra de progreso por completo y muestra una confirmación cálida en su lugar:
Estamos configurando [app] para ti. Esta app necesita una configuración manual, así que nuestro equipo la instala en tu sitio después de que hagas el pedido. Te enviaremos un correo electrónico en el momento en que esté en vivo; no hay nada más que necesites hacer.
Nada falló y nada está pendiente en ti. Las apps son gratuitas, así que no hay cargo de ninguna manera.
Paso 4: Ya Estás en Vivo
En caso de éxito, el asistente muestra [app] está en vivo, un enlace a tu dominio, y el resumen de credenciales:
- Nombre de usuario de administrador
- Contraseña de administrador, con mostrar u ocultar
- Correo electrónico de administrador
- Título del sitio
También muestra el registro de instalación, línea por línea, con cada paso marcado como realizado, fallido o omitido. Ese registro merece una mirada incluso en una instalación limpia: te dice exactamente lo que se configuró.
Dos botones terminan el flujo: Abrir [app] va directamente a la app, y Volver a App regresa a la página del catálogo.
¿Qué Pasa Si Falla
Instalación Fallida. La pantalla de resultados muestra lo que sucedió y plantea la parte importante: Los cambios parciales han sido revertidos. Tu sitio está limpio. Se ofrecen dos acciones, Intentar de Nuevo y Contactar Soporte.
Causas comunes y qué hacer:
- Límites de recursos. Si la RAM mínima de la app es mayor que la que tu plan le proporciona, la instalación puede fallar en el medio. Comprueba la figura Min RAM en la página de la app. Consulta Actualizar Tu Plan.
- Un campo rechazado. El asistente rechaza la entrada que contiene caracteres no seguros para shell antes de que el trabajo sea incluso puesto en cola, y nombra el campo. Simplifica el valor: un nombre de usuario simple, una contraseña generada, un nombre de base de datos solo con letras y números.
- El sitio no está activo. Solo los sitios con estado ACTIVO aparecen en el menú desplegable de sitios. Un sitio aún en proceso de aprovisionamiento no se enumerará.
La instalación tuvo éxito pero el sitio muestra un error. Comprueba el registro de instalación para ver si hay un paso fallido, luego comprueba la documentación propia de la app para la configuración posterior a la instalación. Las apps comunitarias en particular a menudo necesitan un asistente de configuración final ejecutado en el navegador. Consulta Sitio Web No Carga.
Perdiste la contraseña de administrador. Usa el propio restablecimiento de contraseña de la app con el correo electrónico de administrador que configuraste. Para WordPress específicamente, consulta Restablecer una Contraseña de WordPress.
La instalación está atrapada en En Cola. La cola de trabajos está ocupada. Comenzará. Si aún está en cola mucho después del tiempo de instalación esperado, cancélalo e intenta de nuevo, luego abre un ticket de soporte si se repite.