2015-03-22 03:47: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">
2015-03-22 03:47:46 +03:00
<!--
2020-11-09 07:23:58 +03:00
SPDX-License-Identifier: LGPL-2.1-or-later
2017-11-18 19:22:32 +03:00
2018-06-12 20:00:24 +03:00
Copyright © 2015 Chris Morgan
2015-03-22 03:47:46 +03:00
-->
<refentry id= "journal-remote.conf" conditional= 'HAVE_MICROHTTPD'
xmlns:xi="http://www.w3.org/2001/XInclude">
<refentryinfo >
<title > journal-remote.conf</title>
<productname > systemd</productname>
</refentryinfo>
<refmeta >
<refentrytitle > journal-remote.conf</refentrytitle>
<manvolnum > 5</manvolnum>
</refmeta>
<refnamediv >
<refname > journal-remote.conf</refname>
<refname > journal-remote.conf.d</refname>
2016-10-15 23:12:46 +03:00
<refpurpose > Configuration files for the service accepting remote journal uploads</refpurpose>
2015-03-22 03:47:46 +03:00
</refnamediv>
<refsynopsisdiv >
2023-12-14 14:52:03 +03:00
<para > <simplelist >
<member > <filename > /etc/systemd/journal-remote.conf</filename> </member>
<member > <filename > /etc/systemd/journal-remote.conf.d/*.conf</filename> </member>
<member > <filename > /run/systemd/journal-remote.conf.d/*.conf</filename> </member>
<member > <filename > /usr/lib/systemd/journal-remote.conf.d/*.conf</filename> </member>
</simplelist> </para>
2015-03-22 03:47:46 +03:00
</refsynopsisdiv>
<refsect1 >
<title > Description</title>
2016-10-15 23:12:46 +03:00
<para > These files configure various parameters of
2018-04-16 18:09:58 +03:00
<citerefentry > <refentrytitle > systemd-journal-remote.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>
2015-03-22 03:47:46 +03:00
</refsect1>
<xi:include href= "standard-conf.xml" xpointer= "main-conf" />
<refsect1 >
<title > Options</title>
<para > All options are configured in the
2020-07-06 12:00:06 +03:00
[Remote] section:</para>
2015-03-22 03:47:46 +03:00
2019-02-13 12:49:47 +03:00
<variablelist class= 'config-directives' >
2015-12-20 15:23:33 +03:00
<varlistentry >
<term > <varname > Seal=</varname> </term>
<listitem > <para > Periodically sign the data in the journal using Forward Secure Sealing.
2023-08-22 19:52:36 +03:00
</para>
<xi:include href= "version-info.xml" xpointer= "v229" /> </listitem>
2015-12-20 15:23:33 +03:00
</varlistentry>
2015-03-22 03:47:46 +03:00
<varlistentry >
<term > <varname > SplitMode=</varname> </term>
<listitem > <para > One of <literal > host</literal> or <literal > none</literal> .
2023-08-22 19:52:36 +03:00
</para>
<xi:include href= "version-info.xml" xpointer= "v220" /> </listitem>
2015-03-22 03:47: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= "v220" /> </listitem>
2015-03-22 03:47:46 +03:00
</varlistentry>
<varlistentry >
<term > <varname > ServerCertificateFile=</varname> </term>
2023-08-22 19:52:36 +03:00
<listitem > <para > SSL certificate in PEM format.</para>
<xi:include href= "version-info.xml" xpointer= "v220" /> </listitem>
2015-03-22 03:47: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= "v220" /> </listitem>
2015-03-22 03:47:46 +03:00
</varlistentry>
2022-12-17 16:54:16 +03:00
<varlistentry >
<term > <varname > MaxUse=</varname> </term>
<term > <varname > KeepFree=</varname> </term>
<term > <varname > MaxFileSize=</varname> </term>
<term > <varname > MaxFiles=</varname> </term>
<listitem > <para > These are analogous to <varname > SystemMaxUse=</varname> ,
<varname > SystemKeepFree=</varname> , <varname > SystemMaxFileSize=</varname>
and <varname > SystemMaxFiles=</varname> in
<citerefentry > <refentrytitle > journald.conf</refentrytitle> <manvolnum > 5</manvolnum> </citerefentry> .</para>
<para > <varname > MaxUse=</varname> controls how much disk space
the <command > systemd-journal-remote</command> may use up at most.
<varname > KeepFree=</varname> controls how much disk
space <command > systemd-journal-remote</command> shall leave free for other uses.
<command > systemd-journal-remote</command> will respect both limits
and use the smaller of the two values.</para>
<para > <varname > MaxFiles=</varname> controls how many
individual journal files to keep at most. Note that only
archived files are deleted to reduce the number of files until
this limit is reached; active files will stay around. This
means that, in effect, there might still be more journal files
around in total than this limit after a vacuuming operation is
2023-08-22 19:52:36 +03:00
complete.</para>
<xi:include href= "version-info.xml" xpointer= "v253" /> </listitem>
2022-12-17 16:54:16 +03:00
</varlistentry>
2015-03-22 03:47: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 > journald.conf</refentrytitle> <manvolnum > 5</manvolnum> </citerefentry> </member>
<member > <citerefentry > <refentrytitle > systemd</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> </member>
<member > <citerefentry > <refentrytitle > systemd-journal-remote.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> </member>
<member > <citerefentry > <refentrytitle > systemd-journald.service</refentrytitle> <manvolnum > 8</manvolnum> </citerefentry> </member>
</simplelist> </para>
2015-03-22 03:47:46 +03:00
</refsect1>
</refentry>