Manual de Instalación de Laravel 12 con Vite en Subdominio GoDaddy

Manual de Instalación de Laravel 12 con Vite en Subdominio GoDaddy

Esta guía te explica paso a paso cómo instalar Laravel 12 utilizando Vite en un subdominio creado desde cPanel en GoDaddy (hosting compartido).

---

1. Creación del Subdominio en cPanel

1. Ingresa a cPanel y selecciona la opción “Subdominios”.
2. Crea el subdominio, por ejemplo: app2.puertomontt.fun.
3. En el campo “Raíz del documento”, ingresa exactamente:

   /public_html/app2.puertomontt.fun/public

   Esto es esencial para que Apache sirva correctamente los archivos de Laravel y los assets generados por Vite.

---

2. Instalación de Laravel vía SSH

1. Conéctate al servidor por SSH:

   ssh usuario@tudominio.com

2. Ubícate en el directorio:

   cd ~/public_html/app2.puertomontt.fun

3. Ejecuta la instalación:

   laravel new laravel

4. Verifica que la estructura contenga una carpeta public/ dentro del proyecto Laravel.

---

3. Configuración del entorno Laravel (.env)

1. Edita tu archivo .env y asegúrate de que tenga:

   APP_NAME=Laravel
   APP_KEY=
   APP_DEBUG=true
   APP_URL=https://app2.puertomontt.fun
   DB_CONNECTION=mysql
   ...
       

2. Genera la clave:

   php artisan key:generate

3. Asigna permisos adecuados:

   chmod -R 775 storage bootstrap/cache

4. Limpia la caché:

   php artisan config:clear && php artisan optimize:clear

---

4. Compilación de Frontend con Vite

1. Instala dependencias:

   npm install

2. Compila los assets:

   npm run build

3. Verifica que existan archivos dentro de:

   /public/build/manifest.json

   y

   /public/build/assets/

---

5. Seguridad básica en producción

Agrega esto al final de tu archivo public/.htaccess para proteger archivos sensibles:

<FilesMatch "\.(env|log|yml|sql|ini|sh|conf|json|md)$">
  Require all denied
</FilesMatch>

---

6. Diagnóstico de errores comunes

• 404 en assets: Asegúrate de que el subdominio apunta a /public.
• Laravel en blanco: Verifica que APP_KEY esté definido en el .env.
• Vite no genera assets: Ejecuta npm run build y revisa vite.config.js.

---

Publicado por: Equipo Técnico Laravel / Puerto Montt