Asistente de configuración del sitio
Sigue los cuatro pasos del asistente para conectar un repositorio Git, rellenar .env, crear una base de datos y ejecutar el primer despliegue.
Para las aplicaciones compatibles, Sitios → Aplicaciones → Instalación rápida es la opción más rápida. Usa el asistente para conectar tu propio repositorio y controlar manualmente el despliegue, el entorno, la base de datos y el primer despliegue.
Ejemplo de sitio Laravel
Si quieres crear un sitio y desplegar un repositorio Laravel como git@github.com:example/example.com.git, el asistente de configuración es la vía más rápida.
Antes de empezar
- Crear el sitio primero desde Sitios → Nuevo sitio.
- Para Laravel, mantenga la raíz del documento inicial como
web_root/public. - Elija el dominio correcto y la versión PHP antes de abrir el asistente.
- Si el dominio es un dominio apex, puede habilitar opcionalmente el alias
wwwdurante la creación del sitio.
Paso 1 — Despliegue
Llene el repositorio y despliegue la configuración:
- URL del repositorio:
git@github.com:example/example.com.git - Rama: normalmente
main, salvo que el repositorio use otra - Ruta de despliegue: deja el sufijo vacío para clonar el proyecto directamente en
web_root.
Opciones de construcción recomendadas para un proyecto Laravel:
composer install: activadonpm build: actívalo solo si el proyecto gestionado requiere compilar su interfaz con Node. Herne Panel no requiere npm.php artisan migrate: actívalo si vas a crear la base de datos en el paso 3 y escribir las mismas credenciales en.env.optimize / cache clear: activado
Las URL del repositorio SSH activan automáticamente la generación clave cuando sea posible. También puede generar la clave más adelante de la página de Implementación.
Paso 2 — .env
Pruebe o edite los valores de producción .env para la aplicación. Al mínimo, revise estas entradas:
APP_NAMEAPP_ENV=productionAPP_URL=https://your-domainDB_DATABASE,DB_USERNAME,DB_PASSWORD- Correo, cola, caché y cualquier configuración de API de terceros requerido por la aplicación
Si la aplicación utiliza Redis para caché, sesiones o colas, utilice la acción integrada Aplicar predeterminados de Redis antes de guardar.
En un sitio recién creado, el repositorio aún no se ha clonado. Es posible que el asistente todavía no tenga acceso a .env.example. Ten los valores listos para pegarlos manualmente.
Paso 3 — Base de datos
Crea una base de datos MySQL si la aplicación Laravel la necesita.
- Introduce el nombre de la base de datos.
- Introduce el nombre de usuario de la base de datos.
- Establece una contraseña robusta.
- Asegúrate de escribir los mismos valores en
.env.
Si el proyecto no usa una base de datos, puedes omitir este paso.
Si la base de datos ya existe en el servidor, termina el asistente y vincúlala al sitio desde Sitios → Bases de datos → Vincular base de datos existente.
Paso 4 — Primer despliegue
Si el repositorio es privado y el asistente muestra una clave pública de despliegue, sigue estos pasos.
- Copia la clave pública que muestra el asistente.
- Abre el repositorio en GitHub.
- Ve a Settings → Deploy keys → Add deploy key.
- Pega la clave y déjala en modo de solo lectura, salvo que necesites acceso de escritura.
Después de eso, haga clic en Despliegue ahora para clonar el repositorio y ejecutar los pasos seleccionados.
Después del primer despliegue
Los proyectos de Laravel a menudo necesitan unos pocos controles de seguimiento después del despliegue inicial:
- Ejecuta
php artisan key:generatesiAPP_KEYestá vacío. - Ejecuta
php artisan storage:linksi el proyecto necesita el enlace simbólico al almacenamiento público. - Revisa Sitios → Registros si el despliegue devuelve errores.
- Revisa Sitios → Registros → Registros del servidor si aparecen errores de Nginx o PHP-FPM después del despliegue.
- Si el sitio arranca con problemas de configuración, revisa Sitios → Entorno y Sitios → Artisan.
Alternativa de instalación rápida
Use Sitios → Aplicaciones → Instalación rápida para WebBlocks CMS o un esqueleto de App Laravel limpio. WebBlocks CMS crea credenciales de base generadas y configuración CMS; Laravel App instala sólo el esqueleto Laravel para que paquetes como QuizTem puedan instalarse después a través de Composer o Terminal. Ambos flujos escriben valores seguros .env, protegen APP_KEY, verifican la writabilidad del tiempo de ejecución, y mantienen las instalaciones fallidas retráctiles después de la limpieza parcial.