> For the complete documentation index, see [llms.txt](https://serving.konduit.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://serving.konduit.ai/references/cli-commands/serve-command.md).

# Serve Command

```
$ konduit serve [-ad <additional_dependencies>] [-b] [-cp <classpath>] -c
       <server-config>  [-h <host>] [-i <instances>] [-jo <value>]  [-p <port>]
       [-p <profile_name>] [-rwm] [-s <type>] [-id <value>]
```

**OPTIONS**

| Command Flags             | Description                                                                                                                                                                                                              |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| -ad,--addDep              | Additional dependencies to include with the launch.                                                                                                                                                                      |
| -b,--background           | Runs the process in the background, if set.                                                                                                                                                                              |
| -cp,--classpath           | Provides an extra classpath to be used for the verticle deployment.                                                                                                                                                      |
| -c,--config               | Specifies configuration that should be provided to the verticle. `<config>` should reference either a text file containing a valid JSON object which represents the configuration OR be a JSON string.                   |
| -h,--host                 | Specifies the host name of the Konduit server when the configuration provided is just a pipeline configuration instead of a whole inference configuration. Defaults is: `localhost`.                                     |
| -i,--instances            | Specifies how many instances of the server will be deployed. Defaults is: `1`.                                                                                                                                           |
| -jo,--java-opts           | Java Virtual Machine options to pass to the spawned process such as "`-Xmx1G` `-Xms256m -XX:MaxPermSize=256m`". If not set, the `JAVA_OPTS` environment variable is used.                                                |
| -p,--port                 | Specifies the port number of the konduit server when the configuration provided is just a pipeline configuration instead of a whole inference configuration. Defaults is: `0`.                                           |
| -p,--profileName          | Name of the profile to be used with the server launch.                                                                                                                                                                   |
| -rwm,--runWithoutManifest | Do not create the manifest jar file before launching the server.                                                                                                                                                         |
| -s,--service              | Service type that needs to be deployed. Defaults is: `inference`.                                                                                                                                                        |
| -id,--serving-id          | Id of the serving process. This will be visible in the `list` command. This id can be used to call `predict` and `stop` commands on the running servers. If not given then an 8 character UUID is created automatically. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://serving.konduit.ai/references/cli-commands/serve-command.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.