How to Customize a Marketplace App After Deployment

What Happens After Deployment?

When you deploy a Marketplace app on your Breeze, the installer sets up the application with sensible defaults. However, most projects require customization -- changing configurations, adding extensions, or modifying settings to fit your specific use case.

Locating Configuration Files

Marketplace apps are typically installed in /var/www or the application's standard directory. Common configuration locations:

# Web application configs
/var/www/html/.env
/var/www/html/config/app.php
/etc/nginx/sites-available/default
/etc/apache2/sites-available/000-default.conf

Modifying Environment Variables

Most modern apps use a .env file for configuration:

sudo nano /var/www/html/.env

# Common settings to customize
APP_NAME="My Custom App"
APP_URL=https://yourdomain.com
APP_DEBUG=false
MAIL_HOST=smtp.yourdomain.com
DB_DATABASE=myapp_production

Changing the Web Server Configuration

Update the virtual host to use your domain:

sudo nano /etc/nginx/sites-available/default
# Update server_name to your domain
# Adjust root path if needed
sudo nginx -t && sudo systemctl reload nginx

Installing Plugins or Extensions

Use the application's package manager to add functionality:

cd /var/www/html
# For PHP apps with Composer
sudo -u www-data composer require vendor/package-name

# For Node.js apps
sudo -u www-data npm install package-name

Updating File Permissions

After making changes, ensure the web server can read your files:

sudo chown -R www-data:www-data /var/www/html
sudo find /var/www/html -type d -exec chmod 755 {} \;
sudo find /var/www/html -type f -exec chmod 644 {} \;

Tips

• Back up configuration files before making changes
• Keep a changelog of customizations for future reference
• Test changes in a staging environment before applying to production