# Instalación de una aplicación en su sitio

Source: https://support.kapsulehost.com/es-es/apps-installing

El asistente de instalación de Apps realiza tres pasos: configurar la cuenta de administrador y la configuración del sitio, revisar lo que está a punto de suceder, y luego observar la instalación en curso y recopilar sus detalles de inicio de sesión.

## Antes de comenzar

Necesita una cosa: un **sitio web activo** en su cuenta. El asistente se instala en un sitio que ya tiene, no crea uno nuevo. Si no tiene ninguno, el asistente se lo indica y le proporciona un enlace para crear uno. Consulte [Crear su primer sitio web](https://support.kapsulehost.com/es-es/creating-your-first-website).

También necesita el permiso **apps:write**, que poseen los Propietarios y Administradores de la cuenta.

> **Warning:** Haga 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. Consulte [Realizar una copia de seguridad](https://support.kapsulehost.com/es-es/taking-a-backup).

## Acceder al asistente

1. Haga clic en **Apps** en la barra lateral de KPanel.
2. Haga clic en la app que desea.
3. Haga clic en **Instalar [app]** en el panel de la derecha.

La dirección directa es `/apps/<app-slug>/install`.

![El asistente de instalación de apps en KPanel, con el botón Instalar en el panel de la derecha](https://support.kapsulehost.com/help/screenshots/apps-installing.1f6e023d.webp)

## Paso 1: Configurar

El asistente muestra la app y luego cuatro grupos de campos. Aparece un aviso **Actualización de plan recomendada** en la parte superior si la app sugiere un nivel de plan superior al que tiene: es un consejo, y la instalación aún continúa.

### Ubicación

**Instalar en el sitio.** Elija entre sus sitios activos. Este es el lugar 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á sesión, y puede agregar más usuarios más adelante.
- **Contraseña de administrador.** Se genera automáticamente una contraseña segura de 16 caracteres en el momento en que se carga la página. **Mostrar** la revela y **Generar** crea una nueva. También puede escribir la suya; debe tener al menos 8 caracteres.
- **Correo electrónico del administrador.** Opcional. Se utiliza para iniciar sesión y restablecer la contraseña. Si se deja en blanco, se utiliza el correo electrónico de su cuenta.

> **Important:** Guarde 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. KapsuleHost no almacena una copia que pueda recuperar más adelante, por lo que perderla significa restablecer la contraseña a través de la app misma.

### Configuración del sitio

- **Nombre del sitio**, donde la app lo solicita.
- **Idioma.** El idioma en el que se configura la app, elegido entre dieciséis opciones que incluyen inglés (EE.UU.), inglés (Reino Unido), Te Reo Māori y los principales idiomas europeos y asiáticos. Esto establece el idioma de contenido de la app misma, 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 su dominio. Solo letras y números, sin guiones bajos ni guiones: el campo lo impone mientras escribe. Cámbielo si lo desea.

Las apps que necesitan una base de datos la aprovisionan 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 corresponda. Los campos obligatorios se marcan con un asterisco, y **Continuar** permanece deshabilitado hasta que todos se completen.

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.

Haga 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 del administrador, contraseña del administrador (con un conmutador mostrar u ocultar), correo electrónico del administrador, idioma y nombre de la base de datos. El subtítulo lo dice claramente: **nada se instala hasta que confirme**.

- **Editar** retrocede para cambiar algo.
- **Confirmar e instalar** inicia el trabajo.

> **Tip:** Utilice la pantalla de revisión para la verificación más importante: la fila **Sitio web**. Instalar en el sitio incorrecto es el error de instalación más común, y es el que existe el protector de sobrescritura inferior para detectar.

## Paso 3: Instalar

El asistente cambia a una vista de progreso. Verá, en orden:

- **En cola: esperando a un trabajador.** Su trabajo está en la cola y comenzará en breve.
- **Instalando [app]**, con segundos transcurridos contra el tiempo de instalación típico y una barra de progreso.

Mantenga la página abierta. La instalación continúa en segundo plano si se aleja, pero pierde la vista en vivo y el resumen de credenciales al final.

Si la instalación encuentra un problema, se reintenta 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 que ofrece continuar esperando o cancelar.

### Cancelar

**Cancelar la instalación** detiene el trabajo. La pantalla de resultados lo confirma: *La instalación se ha detenido. No se realizó ningún cambio en su 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 [app nueva] lo SOBRESCRIBIRÁ y no se puede deshacer. Se realizará una copia de seguridad completa de su sitio actual para que pueda restaurarlo.

Dos opciones: cancelar, o **Hacer copia y sobrescribir**. Si da su consentimiento, el trabajo realiza una copia de seguridad completa del sitio existente antes de escribir nada, de modo que hay un punto de restauración.

> **Important:** 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 sea reversible con un clic. Si no está seguro de que el sitio sea desechable, cancele e instale en un sitio diferente.

## Apps que nuestro equipo instala manualmente

Algunas apps no tienen un instalador automático comprobado. Para estas, el asistente omite completamente la barra de progreso y muestra una confirmación amable:

> Estamos configurando [app] para usted. Esta app necesita una configuración práctica, por lo que nuestro equipo la instala en su sitio después de que realiza el pedido. Le enviaremos un correo electrónico en el momento en que esté en línea; no hay nada más que deba hacer.

Nada falló y nada está pendiente por su parte. Las apps son gratuitas, así que no hay cargo de ninguna manera.

## Paso 4: Está en línea

En caso de éxito, el asistente muestra **[app] está en línea**, un enlace a su dominio y el resumen de credenciales:

- Nombre de usuario del administrador
- Contraseña del administrador, con mostrar u ocultar
- Correo electrónico del administrador
- Título del sitio

También muestra el **registro de instalación**, línea por línea, con cada paso marcado como exitoso, fallido u omitido. Vale la pena echar un vistazo a ese registro incluso en una instalación limpia: le dice exactamente qué se configuró.

Dos botones finalizan el flujo: **Abrir [app]** va directo a la app, y **Volver a la App** vuelve a la página del catálogo.

## ¿Qué pasa si falla?

**Falló la instalación.** La pantalla de resultados muestra qué sucedió y establece la parte importante: *Todos los cambios parciales han sido revertidos. Su sitio está limpio.* Se ofrecen dos acciones, **Intentar de nuevo** y **Contactar con Soporte**.

Causas comunes y qué hacer:

- **Límites de recursos.** Si la RAM mínima de la app es superior a la que su plan le proporciona, la instalación puede fallar a mitad de camino. Verifique la cifra de **RAM mínima** en la página de la app. Consulte [Actualizar su plan](https://support.kapsulehost.com/es-es/upgrading-your-plan).
- **Un campo rechazado.** El asistente rechaza entrada que contiene caracteres no seguros para shell antes de que el trabajo se ponga en cola, y nombra el campo. Simplifique el valor: un nombre de usuario sencillo, una contraseña generada, un nombre de base de datos con letras y números.
- **El sitio no está activo.** Solo los sitios con estado **ACTIVE** aparecen en el desplegable de sitios. Un sitio aún en aprovisionamiento no se enumerará.

**La instalación se realizó correctamente pero el sitio muestra un error.** Verifique el registro de instalación para buscar un paso fallido, luego consulte la documentación de la app para la configuración posterior a la instalación. Las apps de la comunidad en particular a menudo necesitan ejecutar un asistente de configuración final en el navegador. Consulte [Sitio web no se carga](https://support.kapsulehost.com/es-es/website-not-loading).

**Perdió la contraseña del administrador.** Utilice el restablecimiento de contraseña de la app con el correo electrónico del administrador que configuró. Específicamente para WordPress, consulte [Restablecer una contraseña de WordPress](https://support.kapsulehost.com/es-es/wordpress-reset-password).

**La instalación está atascada en En cola.** La cola de trabajos está ocupada. Comenzará. Si sigue en cola mucho más allá del tiempo de instalación esperado, cancélela e intente de nuevo, luego [abra un ticket de soporte](https://support.kapsulehost.com/es-es/opening-a-support-ticket) si se repite.

## Artículos relacionados

- [El Catálogo de Aplicaciones](https://support.kapsulehost.com/es-es/apps-overview)
- [Instalación de WordPress](https://support.kapsulehost.com/es-es/installing-wordpress)
- [Realizar una copia de seguridad](https://support.kapsulehost.com/es-es/taking-a-backup)
- [Mi Sitio Web No Se Carga: Lista de Verificación de Diagnóstico](https://support.kapsulehost.com/es-es/website-not-loading)
