How to Use Vultr's Laravel Marketplace Application

Laravel is a popular, open-source PHP web framework designed for building modern web applications with elegant syntax. It follows the Model-View-Controller (MVC) architectural pattern and provides powerful features like Eloquent ORM, Blade templating, built-in authentication, and comprehensive tooling for database migrations, task scheduling, and API development. The Vultr Marketplace provides a pre-configured Laravel environment with the complete LAMP stack, enabling quick deployment and setup on a Vultr server.

This guide explains deploying and using Vultr's Laravel Marketplace Application. You will deploy an instance, configure DNS and SSL, connect to a Vultr Managed Database, explore Laravel features, and implement security best practices for deployment.

Deploy Vultr's Laravel Marketplace Application

1. Log in to your Vultr Console and click the Deploy Server button.

2. Select your preferred server type.

3. Choose a server location.

4. Select a server plan with at least 2GB RAM and 2 CPU cores for production workloads.

5. Click the Configure button to proceed.

6. Under Marketplace Apps, search for Laravel and select it as the Marketplace Application.

7. Select the Limited Login option from the Additional Features section to create a limited user with sudo access.

8. Review your configurations and click the Deploy Now button to start deployment.

   Note

   It may take up to 10 minutes for your server to finish installing Laravel and the LAMP stack.

9. After the instance shows the status of Running, navigate to the Server Overview page and copy the SSH connection details.

Initial Setup and Configuration

After deployment, configure DNS, verify the installation, and secure your Laravel application with SSL/TLS before exposing it to production traffic.

1. Create a DNS A record pointing to your server's IP address, such as laravel.example.com.

2. Connect to your Vultr server instance over SSH using the connection details from the Server Overview page.

Verify Laravel Installation

1. Check the Apache web server status.

   CONSOLE

   Copy

   $ sudo systemctl status apache2

   Explain Code

   Powered by Vultr AgentBeta

   The service should show as active (running).

2. Navigate to the Laravel project directory.

   CONSOLE

   Copy

   $ cd /var/www/html/my-laravel-app

   Explain Code

   Powered by Vultr AgentBeta

3. Verify Laravel installation and check the version.

   CONSOLE

   Copy

   $ php artisan --version

   Explain Code

   Powered by Vultr AgentBeta

   Output:

   Laravel Framework 12.34.0

4. Test the application by accessing http://laravel.example.com in a web browser. You should see the default Laravel welcome page.

Configure Firewall Security

Secure your server by configuring the firewall to allow only necessary traffic before enabling SSL.

1. Allow SSH connections.

   CONSOLE

   Copy

   $ sudo ufw allow OpenSSH

   Explain Code

   Powered by Vultr AgentBeta

2. Allow HTTP and HTTPS traffic for Apache and Certbot.

   CONSOLE

   Copy

   $ sudo ufw allow "Apache Full"

   Explain Code

   Powered by Vultr AgentBeta

3. Enable the firewall.

   CONSOLE

   Copy

   $ sudo ufw enable

   Explain Code

   Powered by Vultr AgentBeta

4. Verify firewall status.

   CONSOLE

   Copy

   $ sudo ufw status

   Explain Code

   Powered by Vultr AgentBeta

Secure Laravel with SSL/TLS

Protect your Laravel application with HTTPS using Let's Encrypt certificates via Certbot.

1. Install Certbot and the Apache plugin.

   CONSOLE

   Copy

   $ sudo apt install certbot python3-certbot-apache -y

   Explain Code

   Powered by Vultr AgentBeta

2. Request an SSL certificate for your domain.

   CONSOLE

   Copy

   $ sudo certbot --apache -d laravel.example.com

   Explain Code

   Powered by Vultr AgentBeta

   Follow the prompts and select the option to redirect HTTP traffic to HTTPS when asked.

3. Verify SSL certificate auto-renewal.

   CONSOLE

   Copy

   $ sudo certbot renew --dry-run

   Explain Code

   Powered by Vultr AgentBeta

4. Access your Laravel application securely at https://laravel.example.com.

Configure Laravel Application

Set up your Laravel application environment, configure the database connection, and prepare for deployment.

Update Environment Configuration

1. Navigate to the Laravel project directory.

   CONSOLE

   Copy

   $ cd /var/www/html/my-laravel-app

   Explain Code

   Powered by Vultr AgentBeta

2. Edit the .env file.

   CONSOLE

   Copy

   $ nano .env

   Explain Code

   Powered by Vultr AgentBeta
   INI

   Copy

   APP_NAME="My Laravel App"
   APP_ENV=production
   APP_DEBUG=false
   APP_URL=https://laravel.example.com

   Explain Code

   Powered by Vultr AgentBeta

   Set APP_DEBUG=false to prevent sensitive information leakage.

   Save and close the file.

Set Proper Permissions

1. Set ownership to the web server user.

   CONSOLE

   Copy

   $ sudo chown -R www-data:www-data /var/www/html/my-laravel-app

   Explain Code

   Powered by Vultr AgentBeta

2. Set safe file permissions (644 for files, 755 for directories).

   CONSOLE

   Copy

   $ sudo find /var/www/html/my-laravel-app -type f -exec chmod 644 {} \;
   $ sudo find /var/www/html/my-laravel-app -type d -exec chmod 755 {} \;

   Explain Code

   Powered by Vultr AgentBeta

3. Set writable permissions for storage and cache directories.

   CONSOLE

   Copy

   $ sudo chmod -R 775 /var/www/html/my-laravel-app/storage
   $ sudo chmod -R 775 /var/www/html/my-laravel-app/bootstrap/cache

   Explain Code

   Powered by Vultr AgentBeta

4. Create a symbolic link for public storage.

   CONSOLE

   Copy

   $ cd /var/www/html/my-laravel-app
   $ php artisan storage:link

   Explain Code

   Powered by Vultr AgentBeta

   This allows uploaded files and images to be publicly accessible.

Configure Apache Virtual Host

1. Edit the Apache configuration file for your Laravel application.

   CONSOLE

   Copy

   $ sudo nano /etc/apache2/sites-available/laravel.conf

   Explain Code

   Powered by Vultr AgentBeta
   INI

   Copy

   <VirtualHost *:80>
       ServerName laravel.example.com
       ServerAdmin admin@laravel.example.com
       DocumentRoot /var/www/html/my-laravel-app/public
   
       <Directory /var/www/html/my-laravel-app/public>
           Options -Indexes +FollowSymLinks
           AllowOverride All
           Require all granted
       </Directory>
   
       ErrorLog ${APACHE_LOG_DIR}/laravel-error.log
       CustomLog ${APACHE_LOG_DIR}/laravel-access.log combined
   </VirtualHost>

   Explain Code

   Powered by Vultr AgentBeta

   Replace laravel.example.com with your domain name.

2. Disable the default site and enable Laravel site.

   CONSOLE

   Copy

   $ sudo a2dissite 000-default.conf
   $ sudo a2ensite laravel.conf
   $ sudo a2enmod rewrite

   Explain Code

   Powered by Vultr AgentBeta

3. Test Apache configuration.

   CONSOLE

   Copy

   $ sudo apache2ctl configtest

   Explain Code

   Powered by Vultr AgentBeta

   Output:

   Syntax OK

4. Reload Apache to apply changes.

   CONSOLE

   Copy

   $ sudo systemctl reload apache2

   Explain Code

   Powered by Vultr AgentBeta

Connect to Vultr Managed Database

Enhance your Laravel application's reliability and scalability by connecting to a Vultr Managed Database for MySQL. This provides automatic backups, monitoring, and maintenance.

1. Deploy a Vultr Managed Database for MySQL from the Vultr Console.

2. From the Managed Database dashboard, note the following connection details:

   • Host
   • Port
   • Database name
   • Username
   • Password

3. Edit the Laravel .env file.

   CONSOLE

   Copy

   $ nano /var/www/html/my-laravel-app/.env

   Explain Code

   Powered by Vultr AgentBeta
   INI

   Copy

   DB_CONNECTION=mysql
   DB_HOST=your-managed-db-host.vultr.com
   DB_PORT=16751
   DB_DATABASE=defaultdb
   DB_USERNAME=vultradmin
   DB_PASSWORD=your_secure_password

   Explain Code

   Powered by Vultr AgentBeta

   Save and close the file.

4. Update Laravel's database configuration to require SSL connections.

   CONSOLE

   Copy

   $ nano /var/www/html/my-laravel-app/config/database.php

   Explain Code

   Powered by Vultr AgentBeta

   Locate the mysql configuration array and add SSL settings.

   PHP

   Copy

   'mysql' => [
       'driver' => 'mysql',
       'url' => env('DATABASE_URL'),
       'host' => env('DB_HOST', '127.0.0.1'),
       'port' => env('DB_PORT', '3306'),
       'database' => env('DB_DATABASE', 'forge'),
       'username' => env('DB_USERNAME', 'forge'),
       'password' => env('DB_PASSWORD', ''),
       'unix_socket' => env('DB_SOCKET', ''),
       'charset' => 'utf8mb4',
       'collation' => 'utf8mb4_unicode_ci',
       'prefix' => '',
       'prefix_indexes' => true,
       'strict' => true,
       'engine' => null,
       'options' => extension_loaded('pdo_mysql') ? array_filter([
           PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
           PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT => false,
       ]) : [],
   ],

   Explain Code

   Powered by Vultr AgentBeta

   Save and close the file.

5. Test the database connection.

   CONSOLE

   Copy

   $ php artisan migrate:status

   Explain Code

   Powered by Vultr AgentBeta

   If the connection is successful, you'll see the migration table status.

6. Run database migrations to create tables.

   CONSOLE

   Copy

   $ php artisan migrate

   Explain Code

   Powered by Vultr AgentBeta

7. (Optional) Seed the database with initial data.

   CONSOLE

   Copy

   $ php artisan db:seed

   Explain Code

   Powered by Vultr AgentBeta

Explore Laravel Features

Laravel provides a rich set of features for building modern web applications. This section demonstrates core functionality.

Artisan CLI Commands

Artisan is Laravel's command-line interface for managing your application.

1. List all available Artisan commands.

   CONSOLE

   Copy

   $ php artisan list

   Explain Code

   Powered by Vultr AgentBeta

2. Create a new controller.

   CONSOLE

   Copy

   $ php artisan make:controller ProductController

   Explain Code

   Powered by Vultr AgentBeta

3. Create a new model with migration.

   CONSOLE

   Copy

   $ php artisan make:model Product -m

   Explain Code

   Powered by Vultr AgentBeta

4. Clear application cache.

   CONSOLE

   Copy

   $ php artisan cache:clear
   $ php artisan config:clear
   $ php artisan route:clear
   $ php artisan view:clear

   Explain Code

   Powered by Vultr AgentBeta

Task Scheduling

Laravel's task scheduler allows you to manage scheduled tasks within your application.

1. Edit the server's crontab.

   CONSOLE

   Copy

   $ sudo crontab -e -u www-data

   Explain Code

   Powered by Vultr AgentBeta
   INI

   Copy

   * * * * * cd /var/www/html/my-laravel-app && php artisan schedule:run >> /dev/null 2>&1

   Explain Code

   Powered by Vultr AgentBeta

   This runs Laravel's task scheduler every minute.

2. Define scheduled tasks in app/Console/Kernel.php.

Queue Workers

For handling background jobs, configure Laravel's queue system.

1. Update the .env file to use the database queue driver.

   CONSOLE

   Copy

   $ nano /var/www/html/my-laravel-app/.env

   Explain Code

   Powered by Vultr AgentBeta
   INI

   Copy

   QUEUE_CONNECTION=database

   Explain Code

   Powered by Vultr AgentBeta

   Save and close the file.

2. Create the jobs table.

   CONSOLE

   Copy

   $ php artisan queue:table
   $ php artisan migrate

   Explain Code

   Powered by Vultr AgentBeta

3. Start a queue worker.

   CONSOLE

   Copy

   $ php artisan queue:work --tries=3

   Explain Code

   Powered by Vultr AgentBeta

4. Set up Supervisor to keep the queue worker running.

   CONSOLE

   Copy

   $ sudo apt install supervisor -y

   Explain Code

   Powered by Vultr AgentBeta

5. Create a Supervisor configuration file for the Laravel queue worker.

   CONSOLE

   Copy

   $ sudo nano /etc/supervisor/conf.d/laravel-worker.conf

   Explain Code

   Powered by Vultr AgentBeta
   INI

   Copy

   [program:laravel-worker]
   process_name=%(program_name)s_%(process_num)02d
   command=php /var/www/html/my-laravel-app/artisan queue:work --sleep=3 --tries=3 --max-time=3600
   autostart=true
   autorestart=true
   stopasgroup=true
   killasgroup=true
   user=www-data
   numprocs=1
   redirect_stderr=true
   stdout_logfile=/var/www/html/my-laravel-app/storage/logs/worker.log
   stopwaitsecs=3600

   Explain Code

   Powered by Vultr AgentBeta

   Save and close the file.

6. Start the Supervisor worker.

   CONSOLE

   Copy

   $ sudo supervisorctl reread
   $ sudo supervisorctl update
   $ sudo supervisorctl start laravel-worker:*

   Explain Code

   Powered by Vultr AgentBeta

7. Check the worker status.

   CONSOLE

   Copy

   $ sudo supervisorctl status

   Explain Code

   Powered by Vultr AgentBeta

Best Practices and Configuration

Implement these recommendations to ensure your Laravel application runs securely and efficiently.

Enable Production Optimizations

1. Cache configuration files for faster loading.

   CONSOLE

   Copy

   $ php artisan config:cache

   Explain Code

   Powered by Vultr AgentBeta

2. Cache routes for better performance.

   CONSOLE

   Copy

   $ php artisan route:cache

   Explain Code

   Powered by Vultr AgentBeta

3. Cache views to reduce compilation overhead.

   CONSOLE

   Copy

   $ php artisan view:cache

   Explain Code

   Powered by Vultr AgentBeta

4. Optimize Composer autoloader.

   CONSOLE

   Copy

   $ composer install --optimize-autoloader --no-dev

   Explain Code

   Powered by Vultr AgentBeta

Security Hardening

1. Ensure the .env file is not accessible via the web.

   CONSOLE

   Copy

   $ sudo chmod 600 /var/www/html/my-laravel-app/.env

   Explain Code

   Powered by Vultr AgentBeta

2. Disable directory listing in Apache (already configured in virtual host with -Indexes).

3. Keep Laravel and dependencies updated.

   CONSOLE

   Copy

   $ composer update
   $ php artisan migrate

   Explain Code

   Powered by Vultr AgentBeta

4. Implement rate limiting for API routes in app/Http/Kernel.php.

Monitoring and Logging

1. Configure log channels in config/logging.php.

2. View Laravel logs.

   CONSOLE

   Copy

   $ tail -f /var/www/html/my-laravel-app/storage/logs/laravel.log

   Explain Code

   Powered by Vultr AgentBeta

3. View Apache error logs.

   CONSOLE

   Copy

   $ sudo tail -f /var/log/apache2/laravel-error.log

   Explain Code

   Powered by Vultr AgentBeta

4. Monitor application performance with Laravel Telescope (for development).

   CONSOLE

   Copy

   $ composer require laravel/telescope --dev
   $ php artisan telescope:install
   $ php artisan migrate

   Explain Code

   Powered by Vultr AgentBeta

Troubleshooting

This section covers common issues and diagnostic commands to help resolve problems with your Laravel application.

Check Service Status

1. Verify Apache is running.

   CONSOLE

   Copy

   $ sudo systemctl status apache2

   Explain Code

   Powered by Vultr AgentBeta

2. Check MySQL service (if using local MySQL).

   CONSOLE

   Copy

   $ sudo systemctl status mysql

   Explain Code

   Powered by Vultr AgentBeta

3. View recent Apache error logs.

   CONSOLE

   Copy

   $ sudo tail -50 /var/log/apache2/error.log

   Explain Code

   Powered by Vultr AgentBeta

Common Issues

500 Internal Server Error

1. Check Laravel logs for detailed error messages.

   CONSOLE

   Copy

   $ tail -f /var/www/html/my-laravel-app/storage/logs/laravel.log

   Explain Code

   Powered by Vultr AgentBeta

2. Ensure proper permissions.

   CONSOLE

   Copy

   $ sudo chown -R www-data:www-data /var/www/html/my-laravel-app
   $ sudo chmod -R 775 /var/www/html/my-laravel-app/storage

   Explain Code

   Powered by Vultr AgentBeta

3. Clear all caches.

   CONSOLE

   Copy

   $ php artisan cache:clear
   $ php artisan config:clear
   $ php artisan route:clear

   Explain Code

   Powered by Vultr AgentBeta

Database Connection Issues

1. Open Tinker to test the database connection.

   CONSOLE

   Copy

   $ php artisan tinker

   Explain Code

   Powered by Vultr AgentBeta

2. In the Tinker prompt, run:

   SQL

   Copy

   > DB::connection()->getPdo();

   Explain Code

   Powered by Vultr AgentBeta

3. Verify database credentials in .env file.

4. Check if the Managed Database allows connections from your server's IP.

Permission Denied Errors

1. Fix ownership and permissions.

   CONSOLE

   Copy

   $ sudo chown -R www-data:www-data /var/www/html/my-laravel-app
   $ sudo chmod -R 755 /var/www/html/my-laravel-app
   $ sudo chmod -R 775 /var/www/html/my-laravel-app/storage
   $ sudo chmod -R 775 /var/www/html/my-laravel-app/bootstrap/cache

   Explain Code

   Powered by Vultr AgentBeta

Use Cases

Laravel excels in various real-world application scenarios:

• E-commerce Platforms: Build scalable online stores with Laravel's Eloquent ORM, payment gateway integrations, and inventory management capabilities.
• SaaS Applications: Develop multi-tenant SaaS platforms with Laravel's authentication, authorization, and subscription billing features.
• Content Management Systems: Create custom CMS solutions with Laravel's flexible routing, Blade templating, and media management.
• RESTful APIs: Build robust APIs for mobile and web applications with Laravel's API resources, authentication, and rate limiting.
• Real-time Applications: Implement real-time features like chat, notifications, and live updates using Laravel Echo and WebSockets.
• Enterprise Applications: Develop complex business applications with Laravel's comprehensive tooling, testing capabilities, and maintainable code structure.

Conclusion

In this guide, you deployed Vultr's Laravel Marketplace Application with a complete LAMP stack. You configured DNS, secured the application with SSL/TLS, connected to a Vultr Managed Database for enhanced reliability, and implemented best practices including caching, security hardening, and monitoring. With Laravel's powerful features and Vultr's infrastructure, you can build and deploy scalable, modern web applications efficiently.