Overriding client timeouts

Sometimes, the default timeouts used by the Armeria clients do not suit a particular scenario well. In these cases, you might want to override the timeout settings.

Using ClientBuilder

import java.time.Duration;

import com.linecorp.armeria.client.ClientBuilder;

int responseTimeout = 30;
int writeTimeout = 10;

HelloService.Iface client = new ClientBuilder("tbinary+http://example.com/hello")

Using ClientOptionsBuilder

import java.time.Duration;

import com.linecorp.armeria.common.util.SafeCloseable
import com.linecorp.armeria.client.ClientOptionsBuilder;
import com.linecorp.armeria.client.Clients;

// Defaults are defined in com.linecorp.armeria.common.Flags and
// com.linecorp.armeria.client.ClientOptions
int responseTimeout = 30;
int writeTimeout = 10;

HelloService.Iface client = Clients.newClient(
        new ClientOptionsBuilder()

Adjusting connection-level timeouts

You need to build a non-default ClientFactory using ClientFactoryBuilder to override the default connection-level timeouts such as connect timeout and idle timeout programmatically:

import com.linecorp.armeria.client.ClientFactory;
import com.linecorp.armeria.client.ClientFactoryBuilder;

ClientFactory factory = new ClientFactoryBuilder()
        // Increase the connect timeout from 3.2s to 10s.
        // Shorten the idle connection timeout from 10s to 5s.
        // Note that you can also adjust other connection-level
        // settings such as enabling HTTP/1 request pipelining.

Note that ClientFactory implements java.lang.AutoCloseable and thus needs to be closed when you terminate your application. On close(), ClientFactory will close all the connections it manages and abort any requests in progress.

Using JVM system properties

You can override the default client timeouts by specifying the following JVM system properties if you do not prefer setting it programmatically:

  • -Dcom.linecorp.armeria.defaultClientIdleTimeoutMillis=<integer>

    • the default client-side idle timeout of a connection for keep-alive in milliseconds. Default: 10000

  • -Dcom.linecorp.armeria.defaultConnectTimeoutMillis=<integer>

    • the default client-side timeout of a socket connection attempt in milliseconds. Default: 3200

  • -Dcom.linecorp.armeria.defaultWriteTimeoutMillis=<integer>

    • the default client-side timeout of a socket write attempt in milliseconds. Default: 1000

  • -Dcom.linecorp.armeria.defaultResponseTimeoutMillis=<integer>

    • the default client-side timeout of a response in milliseconds. Default: 15000


The JVM system properties have effect only when you did not specify them programmatically. See Flags for the complete list of JVM system properties in Armeria.