Zerops x Laravel Minimal

A basic Laravel 11 installation running on Zerops, utilizing PostgreSQL for database. Perfect starting point for your Laravel projects.

Deploy on Zerops

You can either click the deploy button to deploy directly on Zerops, or manually copy the import yaml to the import dialog in the Zerops app.

Recipe features

• Laravel running on a load balanced Zerops PHP + Nginx service
• Zerops PostgreSQL 16 service as database
• Proper setup for Laravel cache, optimization, and database migrations
• Logs set up to use syslog and accessible through Zerops GUI
• Utilization of Zerops built-in environment variables system

Production vs. development

Base of the recipe is ready for production, the difference comes down to:

• Use highly available version of the PostgreSQL database (change mode from NON_HA to HA in recipe YAML, db service section)
• Use at least two containers for Jetstream service to achieve high reliability and resilience (add minContainers: 2 in recipe YAML, app service section)
• Use production-ready third-party SMTP server instead of Mailpit (change MAIL_ secret variables in recipe YAML app service)

Changes made over the default installation

If you want to modify your existing Laravel/Jetstream app to efficiently run on Zerops, these are the general steps we took:

• Add zerops.yml to your repository, our example includes database migrations
• Utilize Zerops environment variables and secrets to setup PostgreSQL database connection
• And trustedproxy config to work with reverse proxy load balancer

Need help setting your project up? Join Zerops Discord community.