Skip to content

Commit 9fbad6f

Browse files
committed
docs: explain native-image tool concept in native executable guide
Add explanation of what the native-image tool is and how it can be obtained (locally via GraalVM/Mandrel or through container images) in the Prerequisites section to address feedback that users need conceptual understanding before jumping into implementation steps. Fixes #49398
1 parent 4888304 commit 9fbad6f

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

docs/src/main/asciidoc/building-native-image.adoc

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,8 @@ This guide takes as input the application developed in the xref:getting-started.
1919

2020
== Prerequisites
2121

22+
To build a native executable, Quarkus uses the `native-image` tool that compiles your Java application into a standalone binary. This tool is provided by GraalVM distributions (Oracle GraalVM CE/EE) or Mandrel (a downstream GraalVM distribution optimized for Quarkus). You can get this tool either by installing GraalVM/Mandrel locally on your machine, or by using a container image that includes the tool.
23+
2224
To get started with native executable compilation, you only need:
2325

2426
* A working container runtime (Docker or Podman)
@@ -32,8 +34,8 @@ If you prefer to install GraalVM locally or need to target specific platforms, s
3234
[[container-runtime]]
3335
== Quick Start: Building with Containers
3436

35-
The easiest way to build a native executable is using a container runtime such as Docker or Podman.
36-
This approach requires no local GraalVM installation and works on all platforms.
37+
You can build a native executable using a container runtime such as Docker or Podman.
38+
This approach requires no local GraalVM installation and works on all platforms - the `native-image` tool runs inside a pre-built container.
3739

3840
include::{includes}/devtools/build-native-container.adoc[]
3941

0 commit comments

Comments
 (0)