Feature #41754
closed
Add asset precompilation instructions to doc/INSTALL and doc/UPGRADING
Added by Go MAEDA about 1 month ago.
Updated 10 days ago.
Description
This patch enhances the doc/INSTALL and doc/UPGRADING documentation to include steps for asset precompilation.
With the introduction of Propshaft in Redmine 6.0.0, stylesheets, JavaScript, and images must be compiled. If assets are not precompiled correctly, especially when deploying Redmine in a sub-URI, browsers will fail to load these resources.
This patch adds precompilation instructions to both the installation and upgrade guides to help administrators ensure a smooth setup of Redmine.
Files
- Related to Defect #41734: wrong url for assets in public/assets added
Quoting from Redmine 6.0.0 is now available:
Assets are automatically recompiled in production mode when updates are found in order to not require an additional command, but you can disable this behavior from configuration (config.assets.redmine_detect_update)
Thus, I believe the currently intended approach is NOT to require precompilation.
However, as the assets may be recompiled on each start of Redmine (or only when performing a request? Marius, could you confirm this?), users may have to set the environment variable on each invocation.
We could/should however document how to precompile assets.
- Target version changed from 6.0.2 to Candidate for next minor release
Holger Just wrote in #note-2:
Quoting from Redmine 6.0.0 is now available:
Assets are automatically recompiled in production mode when updates are found in order to not require an additional command, but you can disable this behavior from configuration (config.assets.redmine_detect_update)
Thus, I believe the currently intended approach is NOT to require precompilation.
Oh, I didn't know config.assets.redmine_detect_update
.
I have to update the patch.
Holger Just wrote in #note-2:
Quoting from Redmine 6.0.0 is now available:
However, as the assets may be recompiled on each start of Redmine (or only when performing a request? Marius, could you confirm this?), users may have to set the environment variable on each invocation.
In production mode, only on startup it will compile/recompile the assets.
Go MAEDA wrote in #note-3:
Holger Just wrote in #note-2:
Quoting from Redmine 6.0.0 is now available:
Oh, I didn't know config.assets.redmine_detect_update
.
I have to update the patch.
Yes, I think we should update the docs and RedmineInstall to mention about this configuration flag together with a recommendation. I don't find useful to disable this behaviour for a simple installation with one server.
- Assignee set to Marius BĂLTEANU
- Target version changed from Candidate for next minor release to 6.0.2
- Status changed from New to Closed
- Resolution set to Fixed
Also available in: Atom
PDF