This is an automated email from the ASF dual-hosted git repository. jamesfredley pushed a commit to branch fix/auto-exclude-security-autoconfig in repository https://gitbox.apache.org/repos/asf/grails-spring-security.git
commit 34b806b627b89879de22f51f1ff154ad3304c162 Author: James Fredley <[email protected]> AuthorDate: Thu Feb 19 09:44:31 2026 -0500 docs: add auto-configuration section to installation guide Assisted-by: Claude Code <[email protected]> --- plugin-core/docs/src/docs/introduction/installation.adoc | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/plugin-core/docs/src/docs/introduction/installation.adoc b/plugin-core/docs/src/docs/introduction/installation.adoc index f4214dc9d..fb5429a5d 100644 --- a/plugin-core/docs/src/docs/introduction/installation.adoc +++ b/plugin-core/docs/src/docs/introduction/installation.adoc @@ -72,6 +72,20 @@ dependencies { ./grailsw s2-quickstart com.yourapp User Role ``` +=== Spring Boot Auto-Configuration + +The plugin automatically excludes Spring Boot security auto-configuration classes (such as `SecurityAutoConfiguration`, `SecurityFilterAutoConfiguration`, and `UserDetailsServiceAutoConfiguration`) that conflict with the plugin's own security setup. This means you do not need to manually add `spring.autoconfigure.exclude` entries to your `application.yml`. + +If you need to disable this automatic exclusion - for example, to use Spring Boot's security auto-configuration directly alongside the plugin - set the following property in `application.yml`: + +[source,yaml] +---- +grails: + plugin: + springsecurity: + excludeSpringSecurityAutoConfiguration: false +---- + === Verifying Installation To verify that the plugin has been successfully installed, you can run a simple test:
