Configuration

Detailed configuration options for EcomSec Backup Professional.

Accessing Configuration

1. Go to Einstellungen > System > Plugins
2. Find "EcomSec Backup Professional"
3. Click the 3-dot menu (⋮)
4. Select Konfiguration

Configuration Options

Backup Path

Default: /var/backups

The directory where backups are stored.

Requirements:

• Must be writable by the web server user
• Must have sufficient disk space
• Should NOT be publicly accessible

Examples:

/var/backups                    # VPS/Dedicated (recommended)
/home/username/backups          # Shared Hosting
/var/www/html/var/backups       # Docker

Encryption Key

A randomly generated key used to encrypt backups.

Important:

• Store this key securely (password manager + paper backup)
• Without this key, encrypted backups cannot be restored
• Never share this key with third parties

To regenerate:

1. Click Generate Encryption Key
2. Save the new key securely
3. Note: Old backups cannot be decrypted with the new key

Retention Policy

Number of old backups to keep before automatic deletion.

Recommended values:

Backup Frequency	Retention
Daily	7-14 days
Multiple per day	30 days
Weekly	8-12 weeks

Example:

• Retention: 7
• Frequency: Daily
• Result: Always keep the last 7 backups, delete older ones

Email Notifications

Receive email notifications for backup events.

Options:

• Successful backups
• Failed backups
• Restore operations

Recipient: Admin email from Shopware settings

Default Settings

Compression:

• Default: Enabled
• Recommendation: Keep enabled (saves 70-90% space)

Encryption:

• Default: Disabled
• Recommendation: Enable for production environments

Advanced Configuration

Custom mysqldump Options

Advanced users can specify custom mysqldump options.

Example:

--single-transaction --quick --lock-tables=false

Warning: Only change if you know what you're doing!

Timeout Settings

Backup Timeout: Maximum time for backup operation (default: 3600s)

Increase if you have very large databases.

Saving Configuration

1. Make your changes
2. Click Save at the bottom
3. Configuration is applied immediately

Troubleshooting

Configuration not saving

Solution: Clear cache

bin/console cache:clear

Backup path not writable

Solution: Set correct permissions

chmod 700 /var/backups
chown www-data:www-data /var/backups

Next Steps

• Create your first backup
• Set up automatic backups
• Understand backup types