Cómo subir un proyecto Laravel Filament por SSH a Hostinger

¿Estás trabajando con Laravel Filament y necesitas subir tu proyecto a un hosting como Hostinger? En esta guía paso a paso te muestro cómo desplegar correctamente tu aplicación vía SSH en un hosting compartido. Esta solución también aplica para otros proveedores de hosting estándar.

1. Requisitos previos

• Acceso SSH habilitado en tu panel de Hostinger (o hosting similar).
• PHP 8.x instalado en el servidor (mínimo 8.1 para Filament).
• MySQL o MariaDB activo y configurado.
• Carpeta public_html/ vacía o preparada.

2. Modifica tu archivo .htaccess

Debes asegurarte de que Laravel apunte a su carpeta public. Usa este código en tu archivo raíz:

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^(.*)$ public/$1 [L]
</IfModule>

3. Comandos para limpiar y preparar Laravel

Antes de subir tu proyecto Laravel Filament, ejecuta los siguientes comandos en local:

php artisan optimize:clear
php artisan config:clear
php artisan livewire:publish --config
npm install
npm run build

Esto limpiará la caché y preparará los assets de Livewire para producción.

4. Subir archivos al servidor

• Usa scp desde tu terminal o un cliente como FileZilla (modo SFTP).
• Sube todos los archivos y carpetas de Laravel excepto la carpeta vendor (puedes regenerarla con composer install si tienes acceso SSH completo).
• Ubica tu proyecto dentro de domains/tu-dominio.com/ o public_html/ dependiendo del proveedor.

5. Crear y subir base de datos

• Desde el panel de control de Hostinger, crea una nueva base de datos MySQL.
• Importa tu archivo .sql mediante phpMyAdmin o SSH (comando mysql -u usuario -p nombrebd < dump.sql).

6. Configurar archivo .env

Actualiza las variables principales del archivo .env para producción:

APP_ENV=production
APP_DEBUG=false
APP_URL=https://tudominio.com

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=nombrebd
DB_USERNAME=usuario
DB_PASSWORD=clave

7. Verifica que public/ sea tu raíz

• Verifica que el servidor esté apuntando a la carpeta public/ de Laravel.
• Si no puedes configurar virtual hosts, utiliza el .htaccess mostrado arriba para redirigir correctamente.

8. ¡Listo!

Si seguiste estos pasos, tu proyecto Laravel Filament estará online. Asegúrate de probar las rutas, login y panel de administración. No olvides mantener tus permisos seguros (chmod) y nunca subas tus archivos .env sin seguridad.

¿Buscas ayuda profesional?

Si necesitas un experto en Laravel, Filament, o despliegue en servidores compartidos, puedes contar conmigo. Visita danifigue.com para contratarme como desarrollador Laravel o consultor técnico.