Configuration in code
Ktor allows you to configure various server parameters, such as a host address and port, modules to load, and so on. The configuration depends on the way you used to create a server - embeddedServer or EngineMain.
For embeddedServer
, you can configure server parameters in code by passing the required parameters to the embeddedServer
function. The embeddedServer function accepts different parameters for configuring a server, including a server engine, a host and port to listen, and so on. In this section, we'll take a look at several examples of running embeddedServer
with different setting.
Basic configuration
The code snippet below shows the basic server setup with the Netty engine and the 8080
port.
Note that you can set the port
parameter to 0
to run the server on a random port. The embeddedServer
function returns an engine instance, so you can get a port value in code using the ApplicationEngine.resolvedConnectors function.
Engine configuration
In the example below, we've added the configure
parameter for configuring setting specific for a selected engine. You can learn more about configuring engines from Configure an engine.
Custom environment
The example below shows how to run a server with multiple connector endpoints using a custom configuration represented by the ApplicationEngine interface.
For the complete example, see embedded-server-multiple-connectors.