journal-upload.conf

systemd

journal-upload.conf

journal-upload.conf.d

Configuration files for the journal upload service

/etc/systemd/journal-upload.conf

/run/systemd/journal-upload.conf

/usr/lib/systemd/journal-upload.conf

/etc/systemd/journal-upload.conf.d/*.conf

/run/systemd/journal-upload.conf.d/*.conf

/usr/lib/systemd/journal-upload.conf.d/*.conf

Description

These files configure various parameters of systemd-journal-upload.service(8). See systemd.syntax(7) for a general description of the syntax.

Options

All options are configured in the [Upload] section:

URL=
The URL to upload the journal entries to. See the description of --url= option in systemd-journal-upload(8) for the description of possible values. There is no default value, so either this option or the command-line option must be always present to make an upload.

ServerKeyFile=
SSL key in PEM format.

ServerCertificateFile=
SSL CA certificate in PEM format.

TrustedCertificateFile=
SSL CA certificate.

NetworkTimeoutSec=
When network connectivity to the server is lost, this option configures the time to wait for the connectivity to get restored. If the server is not reachable over the network for the configured time, systemd-journal-upload exits. Takes a value in seconds (or in other time units if suffixed with "ms", "min", "h", etc). For details, see systemd.time(7).

Compression=
Configures compression algorithm to be applied to logs data before sending. Takes a space separated list of compression algorithms, or no. Supported algorithms are zstd, xz, or lz4. Optionally, each algorithm followed by a colon (:) and its compression level, for example zstd:4. The compression level is expected to be a positive integer. When no is specified, no compression algorithm will be applied to data to be sent. This option can be specified multiple times. If an empty string is assigned, then all previous assignments are cleared. Defaults to unset, and all supported compression algorithms with their default compression levels are listed.

Example:

Compression=zstd:4 lz4:2

Even when compression is enabled, the initial requests are sent without compression. It becomes effective either if ForceCompression= is enabled, or the server response contains Accept-Encoding headers with a list of compression algorithms that contains one of the algorithms specified in this option.

ForceCompression=
Takes a boolean value, enforces using compression without content encoding negotiation. Defaults to false.

Header=
Specifies an additional HTTP header to be added to each request to a URL. Takes a pair of header name and value separated with a colon(:), e.g. Name:Value. Header name can contain alphanumeric values, _ and - symbols additionally. This option may be specified more than once, in which case all listed headers will be set. If the same header name is listed more than once, all its unique values will be concatenated with comma. Setting Header= to empty string clears all previous assignments.

Example:

Header=HeaderName: HeaderValue
Header=HeaderName: NewValue
Header=HeaderName: HeaderValue

adds HeaderName header with HeaderValue, NewValue to each HTTP request.