Troubleshooting

Database Connection Issues

• Ensure MariaDB is running and accessible from the container
• Check database credentials in environment variables
• Verify database and user exist with proper permissions
• Check network connectivity between container and database

SFTP Connection Issues

• Check that the SFTP server is running (should show in logs)
• Verify firewall allows connections on SFTP port (default: 2222)
• Ensure OPNsense can reach the server on the configured port
• Check SSH key format - OPNsense requires the private key, not the public key
• Verify the SFTP URI format matches what's displayed in the web interface

Backup Not Appearing

• Check SFTP server logs for connection attempts
• Verify instance identifier matches SFTP username
• Ensure private key in OPNsense matches the generated key
• Check file permissions on the backups directory