# Native image server using YAML configuration file

This example shows how to build a native image for a Ktor application using YAML confinguration and [GraalVM](https://ktor.io/docs/graalvm.html).

## Build

To build the application in native image, you need to execute the following command:

```bash
./gradlew nativeCompile
```

## Run

To run the application, you need to execute the following command:

```bash
./build/native/nativeCompile/com.example.ktor-sample
```

The application will be running at http://0.0.0.0:8080/.

## Update metadata

If new dependencies are added to the project or a project has been modified, some classes may not be included in
the native image. To fix this, you need to update the metadata file.

First you need to run the application with the agent to generate the metadata file:

```bash
./gradlew -Pagent run
```

While the application is running, you need to access basic application functions

It is important to gracefully shutdown the application to generate the metadata file. You can do this by using the [Shutdown URL](https://ktor.io/docs/server-shutdown-url.html):
url: [http://localhost:8080/shutdown](http://localhost:8080/shutdown)

Finally, you can copy to the metadata files:
```bash
./gradlew metadataCopy --task run --dir src/main/resources/META-INF/native-image
```