Skip to content

Deploy a Laravel app on OrbixPanel

Laravel deploys as a PHP app, served from public/ by nginx + php-fpm — no reverse proxy, no port to worry about.

What OrbixPanel does automatically

On deploy, it:

  1. Runs composer install --no-dev --optimize-autoloader.
  2. Creates .env from .env.example if one isn’t present.
  3. Runs php artisan key:generate and php artisan config:clear.
  4. Makes storage/ and bootstrap/cache/ writable by php-fpm.
  5. Serves the public/ directory.

The step you run yourself: migrations

Migrations are not run automatically (that’s deliberate — it touches your data). After the first deploy, configure your database in .env, then from the web terminal:

Terminal window
php artisan migrate --force

Configure .env

Set your real values — database, mail, app URL, and any API keys. Create the database in the panel first and connect on localhost:

APP_ENV=production
APP_DEBUG=false
APP_URL=https://yourdomain.com
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_DATABASE=yourapp
DB_USERNAME=yourapp
DB_PASSWORD=•••••

Pick a modern PHP version

Set the site to PHP 8.x and enable OPcache for a big speed boost — PHP version & OPcache.

Performance

For production, cache config and routes after deploy:

Terminal window
php artisan config:cache && php artisan route:cache && php artisan view:cache

Add Redis for cache and sessions.

Troubleshooting

  • 500 / blank page → check storage/logs/laravel.log; usually a missing .env value or an un-run migration.
  • “Permission denied” writing to storage → see fix permission errors.

Running OrbixPanel? Laravel deploys from Git with composer + key generation handled. OrbixPanel.com → — the free, self-hosted, AI-powered hosting control panel.