How to Troubleshoot Marketplace App Deployment Issues

Common Deployment Problems

Marketplace app deployments are designed to be seamless, but occasionally issues arise. This guide walks through the most common problems and their solutions when deploying apps on your Breeze.

Check Deployment Logs

The first step is always reviewing logs:

# System log for deployment scripts
sudo tail -100 /var/log/syslog

# Web server error logs
sudo tail -50 /var/log/nginx/error.log
sudo tail -50 /var/log/apache2/error.log

# Application logs
sudo tail -50 /var/www/html/storage/logs/laravel.log

Common Issues and Fixes

502 Bad Gateway or Blank Page

Usually caused by PHP-FPM not running or misconfigured:

sudo systemctl status php8.2-fpm
sudo systemctl restart php8.2-fpm

# Check PHP-FPM socket exists
ls -la /run/php/php8.2-fpm.sock

Database Connection Errors

Verify the database credentials in the application config:

# Check MySQL is running
sudo systemctl status mysql

# Test the connection manually
mysql -u app_user -p -e "SHOW DATABASES;"

# Verify .env database settings
grep DB_ /var/www/html/.env

Permission Denied Errors

File ownership issues are the most frequent cause:

sudo chown -R www-data:www-data /var/www/html
sudo chmod -R 755 /var/www/html/storage
sudo chmod -R 755 /var/www/html/bootstrap/cache

Port Conflicts

Check if another service is using the required port:

sudo ss -tlnp | grep :80
sudo ss -tlnp | grep :443

Redeploying the App

If troubleshooting does not resolve the issue, you can redeploy the Marketplace app from your portal. Navigate to your Breeze dashboard, select the Marketplace app, and choose the redeploy option. This reinstalls the app with fresh defaults while preserving your data where possible.

Getting Help

• Include relevant error logs when contacting support
• Note the exact app name and version you deployed
• Describe any customizations made after initial deployment