This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new 07e913e7b796 CAMEL-22243: camel-launcher docs
07e913e7b796 is described below
commit 07e913e7b796eb3d0e2eb6b81a63cbe2318fc37f
Author: Claus Ibsen <[email protected]>
AuthorDate: Sat Dec 27 19:50:16 2025 +0100
CAMEL-22243: camel-launcher docs
---
docs/user-manual/modules/ROOT/nav.adoc | 5 +-
.../modules/ROOT/pages/camel-jbang-launcher.adoc | 64 ++++++++++++++++++++++
.../modules/ROOT/pages/camel-jbang.adoc | 5 ++
3 files changed, 72 insertions(+), 2 deletions(-)
diff --git a/docs/user-manual/modules/ROOT/nav.adoc
b/docs/user-manual/modules/ROOT/nav.adoc
index ba1f60db2861..dca81b368078 100644
--- a/docs/user-manual/modules/ROOT/nav.adoc
+++ b/docs/user-manual/modules/ROOT/nav.adoc
@@ -6,8 +6,9 @@
** xref:building.adoc[Building]
** xref:camel-console.adoc[Camel Developer Console]
** xref:camel-jbang.adoc[Camel JBang]
-*** xref:camel-jbang-kubernetes.adoc[Camel Kubernetes plugin]
-*** xref:camel-jbang-test.adoc[Camel Testing plugin]
+*** xref:camel-jbang-launcher.adoc[Camel JBang Launcher]
+*** xref:camel-jbang-kubernetes.adoc[Camel JBang Kubernetes plugin]
+*** xref:camel-jbang-test.adoc[Camel JBang Testing plugin]
** xref:camel-maven-plugin.adoc[Camel Maven Plugin]
** xref:camel-component-maven-plugin.adoc[Camel Component Maven Plugin]
** xref:camel-report-maven-plugin.adoc[Camel Maven Report Plugin]
diff --git a/docs/user-manual/modules/ROOT/pages/camel-jbang-launcher.adoc
b/docs/user-manual/modules/ROOT/pages/camel-jbang-launcher.adoc
new file mode 100644
index 000000000000..388184adbb49
--- /dev/null
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang-launcher.adoc
@@ -0,0 +1,64 @@
+= Camel JBang Launcher
+
+*Available as of Camel 4.13*
+
+This module provides a self-contained executable JAR that includes all
dependencies required to run Camel JBang without the need for the JBang
two-step process.
+
+The launcher uses Spring Boot's loader tools to create a self-executing JAR
with a nested structure, similar to Spring Boot's executable JARs. This
provides better performance and avoids classpath conflicts compared to
traditional fat JARs.
+
+== Downloading
+
+You can download the `camel-launcher` JAR from
https://repo1.maven.org/maven2/org/apache/camel/camel-launcher/[Maven Central].
+
+== Using the fat-jar directly
+
+Then you can run the JAR using standard Java as follows:
+
+[source,bash]
+----
+java -jar camel-launcher-<version>.jar [command] [options]
+----
+
+For example:
+
+[source,bash]
+----
+java -jar camel-launcher-<version>.jar version
+java -jar camel-launcher-<version>.jar run hello.java
+----
+
+== Using the distribution (recommended)
+
+Extract the distribution archive:
+
+[source,bash]
+----
+unzip camel-launcher-<version>-bin.zip
+# or
+tar -xzf camel-launcher-<version>-bin.tar.gz
+----
+
+And then use the provided scripts:
+
+[source,bash]
+----
+# On Unix/Linux
+./bin/camel.sh [command] [options]
+
+# On Windows
+bin\camel.bat [command] [options]
+----
+
+== Benefits of using Camel Launcher
+
+- No need for JBang installation
+- Single executable JAR with all dependencies included
+- Faster startup time (no dependency resolution step, on-demand class loading)
+- Better memory usage (only loads classes that are actually used)
+- Avoids classpath conflicts (dependencies kept as separate JARs)
+- Each self-executing JAR is its own release, avoiding version complexity
+- Can still be used with JBang if preferred
+
+== More Information
+
+See the general xref:camel-jbang.adoc[Camel JBang] documentation.
diff --git a/docs/user-manual/modules/ROOT/pages/camel-jbang.adoc
b/docs/user-manual/modules/ROOT/pages/camel-jbang.adoc
index 76f54b3115eb..de6b856c6b9c 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-jbang.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang.adoc
@@ -30,6 +30,11 @@ Note: It requires access to the internet, in case of using a
proxy, please ensur
If Camel JBang is not working with your current configuration,
please look to
https://www.jbang.dev/documentation/jbang/latest/configuration.html#proxy-configuration[Proxy
configuration in JBang documentation].
+=== Installing without JBang
+
+It is also possible to install and run Camel JBang without _JBang_ using the
xref:camel-jbang-launcher.adoc[Camel JBang Launcher] which essentially is
+a standard Java _fat-jar_ with launch scripts.
+
=== Installing a specific Camel JBang version
By default, Camel JBang installs the latest release, which may not be the
desired version.
