2016-10-15 23:12:46 +03:00
<?xml version='1.0'?> <!-- * - nxml - * -->
2019-03-14 16:40:58 +03:00
< !DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
2023-12-25 17:48:33 +03:00
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
2020-11-09 07:23:58 +03:00
<!-- SPDX - License - Identifier: LGPL - 2.1 - or - later -->
2016-10-15 23:12:46 +03:00
<refentry id= "journal-upload.conf" conditional= 'HAVE_MICROHTTPD'
xmlns:xi="http://www.w3.org/2001/XInclude">
<refentryinfo >
<title > journal-upload.conf</title>
<productname > systemd</productname>
</refentryinfo>
<refmeta >
<refentrytitle > journal-upload.conf</refentrytitle>
<manvolnum > 5</manvolnum>
</refmeta>
<refnamediv >
<refname > journal-upload.conf</refname>
<refname > journal-upload.conf.d</refname>
<refpurpose > Configuration files for the journal upload service</refpurpose>
</refnamediv>
<refsynopsisdiv >
<para > <filename > /etc/systemd/journal-upload.conf</filename> </para>
2024-02-22 12:58:48 +03:00
<para > <filename > /run/systemd/journal-upload.conf</filename> </para>
<para > <filename > /usr/lib/systemd/journal-upload.conf</filename> </para>
2016-10-15 23:12:46 +03:00
<para > <filename > /etc/systemd/journal-upload.conf.d/*.conf</filename> </para>
<para > <filename > /run/systemd/journal-upload.conf.d/*.conf</filename> </para>
<para > <filename > /usr/lib/systemd/journal-upload.conf.d/*.conf</filename> </para>
</refsynopsisdiv>
<refsect1 >
<title > Description</title>
<para > These files configure various parameters of
2018-04-16 18:09:58 +03:00
<citerefentry > <refentrytitle > systemd-journal-upload.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> .
See
2020-07-11 01:05:23 +03:00
<citerefentry > <refentrytitle > systemd.syntax</refentrytitle> <manvolnum > 7</manvolnum> </citerefentry>
2018-04-16 18:09:58 +03:00
for a general description of the syntax.</para>
2016-10-15 23:12:46 +03:00
</refsect1>
<xi:include href= "standard-conf.xml" xpointer= "main-conf" />
<refsect1 >
<title > Options</title>
2020-07-06 12:00:06 +03:00
<para > All options are configured in the [Upload] section:</para>
2016-10-15 23:12:46 +03:00
2019-02-13 12:49:47 +03:00
<variablelist class= 'config-directives' >
2016-10-15 23:12:46 +03:00
<varlistentry >
<term > <varname > URL=</varname> </term>
<listitem > <para > The URL to upload the journal entries to. See the description
2019-11-21 22:33:26 +03:00
of <option > --url=</option> option in
2016-10-15 23:12:46 +03:00
<citerefentry > <refentrytitle > systemd-journal-upload</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry>
2018-05-08 11:39:18 +03:00
for the description of possible values. There is no default value, so either this
2023-08-22 19:52:36 +03:00
option or the command-line option must be always present to make an upload.</para>
<xi:include href= "version-info.xml" xpointer= "v232" /> </listitem>
2016-10-15 23:12:46 +03:00
</varlistentry>
<varlistentry >
<term > <varname > ServerKeyFile=</varname> </term>
2023-08-22 19:52:36 +03:00
<listitem > <para > SSL key in PEM format.</para>
<xi:include href= "version-info.xml" xpointer= "v232" /> </listitem>
2016-10-15 23:12:46 +03:00
</varlistentry>
<varlistentry >
<term > <varname > ServerCertificateFile=</varname> </term>
2023-08-22 19:52:36 +03:00
<listitem > <para > SSL CA certificate in PEM format.</para>
<xi:include href= "version-info.xml" xpointer= "v232" /> </listitem>
2016-10-15 23:12:46 +03:00
</varlistentry>
<varlistentry >
<term > <varname > TrustedCertificateFile=</varname> </term>
2023-08-22 19:52:36 +03:00
<listitem > <para > SSL CA certificate.</para>
<xi:include href= "version-info.xml" xpointer= "v232" /> </listitem>
2016-10-15 23:12:46 +03:00
</varlistentry>
2021-06-05 16:33:54 +03:00
<varlistentry >
<term > <varname > NetworkTimeoutSec=</varname> </term>
<listitem > <para > 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, <command > systemd-journal-upload</command>
exits. Takes a value in seconds (or in other time units if suffixed with "ms", "min", "h", etc).
For details, see <citerefentry > <refentrytitle > systemd.time</refentrytitle> <manvolnum > 5</manvolnum> </citerefentry> .
2023-08-22 19:52:36 +03:00
</para>
<xi:include href= "version-info.xml" xpointer= "v249" /> </listitem>
2021-06-05 16:33:54 +03:00
</varlistentry>
2016-10-15 23:12:46 +03:00
</variablelist>
</refsect1>
<refsect1 >
<title > See Also</title>
2023-12-22 21:09:32 +03:00
<para > <simplelist type= "inline" >
<member > <citerefentry > <refentrytitle > systemd-journal-upload.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> </member>
<member > <citerefentry > <refentrytitle > systemd</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> </member>
<member > <citerefentry > <refentrytitle > systemd-journald.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> </member>
</simplelist> </para>
2016-10-15 23:12:46 +03:00
</refsect1>
</refentry>