diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/docker-compose.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/docker-compose.adoc
index 2a53c585ddf..f25f3b4e443 100644
--- a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/docker-compose.adoc
+++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/features/docker-compose.adoc
@@ -38,6 +38,11 @@ When this module is included as a dependency Spring Boot will do the following:
 If the Docker Compose services are already running when starting the application, Spring Boot will only create the service connection beans for each supported container.
 It will not call `docker compose up` again and it will not call `docker compose stop` when the application is shutdown.
 
+TIP: Repackaged archives do not contain Spring Boot's Docker Compose by default.
+If you want to use this support, you need to include it.
+When using the Maven plugin, set the `excludeDockerCompose` property to `false`.
+When using the Gradle plugin, {spring-boot-gradle-plugin-docs}#packaging-executable-configuring-including-development-only-dependencies[configure the task's classpath to include the `developmentOnly` configuration].
+
 
 
 [[features.docker-compose.prerequisites]]