Configuration Properties

The HTTP server can be configured using any of all of the following properties. Note that these settings only apply to the default implementation provided by Tigase HTTP API.

This property is used to configure on which ports on HTTP server should listen for incoming connections. If it is not set then default port 8080 will be used

It is used to group configurations passed to ports


For every {port} you can pass separate configuration. To do so you will need to replace {port} with port number, ie. 8080. For every port you can pass following properties:


Sets type of socket used for handling incoming connections. Accepted values are:

  • plain - port will work in plain HTTP mode (default)
  • ssl - port will work in HTTPS mode
This property is used to configure domain name of SSL certificate which should be used by HTTP server running on this port (if socket is set to ssl). If it is not set (or it will be omitted) then Tigase XMPP Server will try to use SSL certificate for the host to which client tries to connect. If there will be no SSL certificate for that domain name, then default SSL certificate of Tigase XMPP Server will be used.

Additional properties of embedded HTTP server

With embedded HTTP server, you have a few additional properties within executor section, which you can pass to adjust this HTTP server.


Name of the subsection

This property is used to configure the number of threads used to handle HTTP requests, ie. 10
Property used to set timeout for processing a single HTTP request (in milliseconds), ie. 30000
Property used to set timeout for reading HTTP request headers (in milliseconds), ie. 2000