hot-reload.md

description
Enable hot reload through SIGHUP signal or an HTTP endpoint

Hot Reload

Fluent Bit supports the hot reloading feature when enabled via the command line with -Y or --enable-hot-reload option.

Getting Started

To get started with reloading via HTTP, the first step is to enable the HTTP Server from the configuration file:

[SERVICE]
    HTTP_Server  On
    HTTP_Listen  0.0.0.0
    HTTP_PORT    2020

# Other stuff of plugin configurations

The above configuration snippet will enable the HTTP endpoint for hot reloading.

How to reload

Via HTTP

Hot reloading can be kicked via HTTP endpoints that are:

• PUT /api/v2/reload
• POST /api/v2/reload

If users don't enable the hot reloading feature, hot reloading via these endpoints will not work.

For using curl to reload fluent-bit, users must specify an empty request body as:

$ curl -X POST -d {} localhost:2020/api/v2/reload

Via Signal

Hot reloading also can be kicked via SIGHUP.

SIGHUP signal is not supported on Windows. So, users can't enable this feature on Windows.

Limitations

The hot reloading feature is currently working on Linux and macOS. Windows is not supported yet.