HAProxy Enterprise Documentation 2.3r1

Runtime API

The Runtime API is embedded inside the load balancer and requires no other packages. It lets you configure some aspects of the load balancer at runtime without needing to reload the service. Changes are kept in memory only until the next reload or restart and are not saved to the configuration file on disk. Use this feature to make on-the-fly changes, such as enabling and disabling servers or adding entries to map files in memory.


Get an overview of the Runtime API.

abort ssl cert

Abort an SSL certificate transaction.

add acl

Add a value to an ACL expression or file.

add map

Add an entry to a Map file.

add ssl crt-list

Add an entry to an SSL CRT list.

clear acl

Delete all entries from an ACL expression or file.

clear counters all

Clear all counters on the Stats page.

clear counters

Clear the Max counters on the Stats page.

clear map

Delete all entries from a Map file.

clear table

Remove one or more entries from a stick table.

commit ssl cert

Commit an SSL certificate transaction.

del acl

Delete a single value from an ACL expression or file.

del map

Delete a single entry from a Map file.

del ssl cert

Delete a single SSL certificate from memory.

del ssl crt-list

Delete an entry from an SSL CRT list.

disable agent

Stop sending health check probes to an agent program running on a server.

disable dynamic-cookie backend

Enable session persistence when dynamic cookies are in use.

disable frontend

Stop routing traffic to a frontend that is declared in your HAProxy Enterprise configuration file.

disable health

Stop sending active health check probes to a server.

disable server

Put a server in maintenance mode.

enable agent

Resume sending health check probes to an agent program running on a server.

enable dynamic-cookie backend

Enable session persistence when dynamic cookies are in use.

enable frontend

Re-enable a frontend that was stopped.

enable health

Enable active health checks for a server.

enable server

Take a server out of maintenance mode.

get acl

Test whether a value would match an ACL.

get map

Test whether an input matches an entry in a map file.

get weight

Display the initial and current weight of a server.


Display a list of available Runtime API commands.

new ssl cert

Add a new, empty SSL certificate store.


Decrease the CLI level to operator.


Initiate an interactive session with the Runtime API.


Disconnect from the Runtime API.

set dynamic-cookie-key backend

Change the value of the dynamic-cookie-key directive.

set map

Change the value of a map file entry.

set maxconn frontend

Change a frontend's maximum concurrent connections.

set maxconn global

Change the load balancer's process-side maximum concurrent connections.

set maxconn server

Change a server's maximum concurrent connections.

set rate-limit connections global

Set the process-wide connection rate limit.

set rate-limit http-compression global

Set the process-wide compression rate limit.

set rate-limit sessions global

Set the process-wide session rate limit.

set rate-limit ssl-sessions global

Set the process-wide SSL session rate limit.

set server

Change a server's properties.

set severity-output

Change the severity level format.

set ssl cert

Add an SSL certificate to a transaction.

set ssl ocsp-response

Set the Online Certificate Status Protocol (OCSP) response for an SSL/TLS certificate.

set ssl tls-key

Rotate the load balancer's session ticket encryption key used to encrypt TLS session tickets.

set table

Add or update a record in a stick table.

set timeout cli

Change the timeout period for an interactive session with the Runtime API.

set weight

Change the weight of a server.

show acl

List all ACLs defined in the configuration.

show backend

List all backends in the current running config.

show cache

Show cache status.

show cli level

Display the CLI level of the current session.

show cli sockets

Display information about all CLI sockets defined in the configuration.

show env

Display current HAProxy Enterprise process and environment information.

show errors

Show errors related to protocol violations.

show events

Show events from a running trace.

show info

Display information about the HAProxy Enterprise process.

show map

List map files or list the entries in a map file.

show peers

Display information about stick table data synchronized between load balancer peers.

show pools

Show the status of internal memory pools.

show resolvers

Display statistics for each resolvers section in your configuration.

show schema json

Display the JSON schema for the output of the 'show info' and 'show stat' commands.

show servers conn

Dump the current and idle connections for a backend or backends.

show servers state

Get a block of data that represents the current of servers in backends.

show sess

Display all clients that have an ongoing session connected to the load balancer.

show ssl cert

List certificates used on frontends.

show ssl crt-list

Display the contents of an SSL CRT list.

show stat

Get statistics that describe traffic flowing through the load balancer.

show table

List entries in a stick table.

show threads

Show the internal states and structures of threads.

show tls-keys

Display the secret keys used to encrypt TLS session tickets.

show trace

Display the state and monitored events for a trace.

shutdown frontend

Delete a frontend and release the ports on which it listens.

shutdown session

Terminate a client's session.

shutdown sessions server

Terminate all client sessions that are connected to a specific server.


Monitor load balancer events in real-time using a trace.


Decrease the CLI level to user.

Next up