Prerequisites
Describe the issue
Describe the issue:
During an upgrade from Roundcube 1.6.15 to 1.7.0 I encountered an issue caused by the new mandatory public_html webroot structure.
The upgrade process itself completed successfully, and Composer finally reported:
This instance of Roundcube is up-to-date. Have fun!
However, after the upgrade the web interface displayed only:
Please, configure your HTTP server to point to the /public_html directory (with fallback to /public_html/index.php).
The issue was caused by the existing Apache DocumentRoot still pointing to the main Roundcube directory instead of the new required:
DocumentRoot /path/to/roundcube/public_html
Suggestion
In my opinion this should be much more explicitly documented in UPGRADING.md as a mandatory post-upgrade step for existing installations.
Currently it is easy to overlook because:
the upgrade itself appears successful,
Composer finishes without clear warning about webroot migration,
administrators upgrading older installations naturally keep their existing virtual host configuration,
the error page looks more like a generic placeholder/debug page than a migration requirement.
A short dedicated section such as:
IMPORTANT: Roundcube 1.7 requires your web server DocumentRoot to point to the public_html directory
would probably save many administrators troubleshooting time.
What browser(s) are you seeing the problem on?
No response
What version of PHP are you using?
No response
What version of Roundcube are you using?
1.7.0
JavaScript errors
No response
PHP errors
No response
Prerequisites
Describe the issue
Describe the issue:
During an upgrade from Roundcube 1.6.15 to 1.7.0 I encountered an issue caused by the new mandatory public_html webroot structure.
The upgrade process itself completed successfully, and Composer finally reported:
This instance of Roundcube is up-to-date. Have fun!
However, after the upgrade the web interface displayed only:
Please, configure your HTTP server to point to the /public_html directory (with fallback to /public_html/index.php).
The issue was caused by the existing Apache DocumentRoot still pointing to the main Roundcube directory instead of the new required:
DocumentRoot /path/to/roundcube/public_html
Suggestion
In my opinion this should be much more explicitly documented in UPGRADING.md as a mandatory post-upgrade step for existing installations.
Currently it is easy to overlook because:
the upgrade itself appears successful,
Composer finishes without clear warning about webroot migration,
administrators upgrading older installations naturally keep their existing virtual host configuration,
the error page looks more like a generic placeholder/debug page than a migration requirement.
A short dedicated section such as:
IMPORTANT: Roundcube 1.7 requires your web server DocumentRoot to point to the public_html directory
would probably save many administrators troubleshooting time.
What browser(s) are you seeing the problem on?
No response
What version of PHP are you using?
No response
What version of Roundcube are you using?
1.7.0
JavaScript errors
No response
PHP errors
No response