KOPANO-ARCHIVER.CFG(5)

📦 version 8.7.0, in ubuntu jammy

✨ KOPANO-ARCHIVER.CFG(5) ✨

okay bestie so like, welcome to the Kopano Core user reference for kopano-archiver.cfg — that's the manual name btw, section 5, and yes she's iconic 💅

💖 NAME 💖

kopano-archiver.cfg — the Kopano archiver configuration file. that's it, that's the whole thing, she's the config file, she's the moment 🎀

🌸 SYNOPSIS 🌸

archiver.cfg

🦋 DESCRIPTION 🦋

so archiver.cfg is the configuration file for the Kopano Archiver. it's literally holding all the instructions the software needs to set up its logging system, plus the specific actions the archiver is allowed to do. she's the blueprint, no cap 🫶

⭐ FILE FORMAT ⭐

okay so the file is one big section, right? but like, the parameters can still be grouped by functionality, so it's not just chaos, it's curated chaos 💅

parameters get written like this:

name = value

the file is line-based, meaning every newline-terminated line is either a comment, nothing, a parameter, or a directive. a line that starts with # is a comment and Kopano will simply ignore it (rude of you to read it, honestly). parameter names are case sensitive, so don't get cute with the capitals. and lines beginning with ! are directives.

directives look like this:

!directive [argument(s)]

and the directives that exist are:

💫 include

include and process argument

Example: !include common.cfg

🎀 EXPLANATION OF EACH PARAMETER 🎀

🔌 server_socket

Unix socket to find the connection to the Kopano server.

Default: file:///var/run/kopano/server.sock

🔑 sslkey_file

use this file as the key to logon to the server. this is only used when server_socket is set to an HTTPS transport. see the kopano-server(8) manual page for how to set up SSL keys, bestie.

Default: value not set.

🤫 sslkey_pass

the password of the SSL key file that is set in sslkey_file.

Default: value not set.

📦 archive_enable

specifies if the archive step will be performed. the archive step is basically the copy to the archive. lowkey the main character of this whole config ngl.

Default: yes

⏳ archive_after

specifies the age in days of a message before it will be archived.

Default: 30

✂️ stub_enable

specifies if the stub step will be performed. stubbing is the process of removing the data from a message and only leaving a reference to one or more archived versions of that message. when such a message is opened it will be de-stubbed on the fly, leaving the user with a normal message to work with. it's giving sleight of hand ✨

a message will never be stubbed if it's not yet archived.

Default: no

👀 stub_unread

specifies if unread messages will be stubbed.

Default: no

⏳ stub_after

specifies the age in days of a message before it will be stubbed.

Default: 0

🗑️ delete_enable

specifies if the delete step will be performed. the delete step deletes messages from the users store if they're old enough. this way even more space is freed. she's generous like that 💖

a message will never be deleted if it's not yet archived.
a message will never be deleted from the archive.

Default: no

🙈 delete_unread

specifies if unread messages will be deleted.

Default: no

⏳ delete_after

specifies the age in days of a message before it will be deleted.

Default: 0

🧹 purge_enable

specifies if message will be purged from the archive after a certain amount of time.

Default: no

⏳ purge_after

specifies the age in days of a message before it will be purged. Note that the age is measured from the time it was originally delivered in the primay store. (yes it says "primay" in the original, we're keeping her exactly as she is, no editing bestie 💀)

Default: 0

🕰️ track_history

specifies the behaviour of the archiver when re-archiving messages that were changed after they were archived. when track_history is set to no, the archived version will be updated to contain the most actual information. when track_history is set to yes, a new copy of the message will be created in the archive, and the previous version is linked to it. this way the change history can be tracked. it's literally keeping receipts 📝

Default: no

🧼 cleanup_action

specify what action should be taken on archive messages whose primary message has been deleted. the options are store and delete, meaning store the archived message in a special Deleted folder, or delete the archived messages respectively.

Default: store

🔗 cleanup_follow_purge_after

specify if items that are cleaned up from the archive are at least the age that is specified in the purge_after setting. this is to avoid messages being deleted from the archive when they where deleted from the primary store by a delete operation. note that setting to yes will cause a cleanup run to seemingly do nothing (not a bug, she's just being careful okay 😭). a rule of thumb is to set this to the same value as delete_enable. so when delete_enable is set to yes, make sure cleanup_follow_purge_after is also set to yes.

Default: no

📎 enable_auto_attach

specify whether on each archive run an auto-attach run is performed in order to match the attached archives to the requested state as specified in LDAP or ADS.

Default: no

✍️ auto_attach_writable

specify whether an auto attached archive will be granted write permissions for the user it's attached to.

Default: yes

📝 log_method

the method which should be used for logging. valid values are:

  • syslog — use the syslog service. messages will be sent using the "mail" facility tag. see also journald.conf(5) or syslog.conf(5).
  • file — log to a file. the filename will be specified in log_file.
  • auto — autoselect mode: if log_file is set, that will be used. else, syslog will be used if it looks like it is available. else, stderr.

Default: auto

📄 log_file

when logging to a file, specify the filename in this parameter. use - (minus sign) for stderr output.

Default: -

⏰ log_timestamp

specify whether to prefix each log line with a timestamp in 'file' logging mode.

Default: 1

🧺 log_buffer_size

buffer logging in what sized blocks. the special value 0 selects line buffering.

Default: 0

🔊 log_level

the level of output for logging in the range from 0 to 6. "0" means no logging, "1" for critical messages only, "2" for error or worse, "3" for warning or worse, "4" for notice or worse, "5" for info or worse, "6" debug. pick your fighter 💅

Default: 3

🆔 pid_file

the location of the pid file used to guarantee only one instance of kopano-archiver is running in non-administrative mode. one girl, one pid, periodt 👑

Default: /var/run/kopano/archiver.pid

🐬 EXPLANATION OF THE MYSQL SETTINGS PARAMETERS 🐬

🖥️ mysql_host

the hostname of the MySQL server to use.

Default: localhost

🚪 mysql_port

the port of the MySQL server to use.

Default: 3306

🧑 mysql_user

the user under which we connect with MySQL.

Default: root

🔐 mysql_password

the password to use for MySQL. leave empty for no password.

Default:

🧦 mysql_socket

the socket of the MySQL server to use. this option can be used to override the default mysql socket. to use the socket, the mysql_host value must be empty or 'localhost'

Default:

🗄️ mysql_database

the MySQL database to connect to.

Default: kopano

⚙️ mysql_engine

the MySQL engine to use. by default, this is InnoDB, which is the only officially supported database engine. because Kopano Groupware Core relies on transactions, it is not advised to use a non-transactional engine such as MyISAM, Aria, etc.

Default: InnoDB

📁 FILES 📁

  • /etc/kopano/archiver.cfg — the Kopano archiver configuration file.

✍️ AUTHOR ✍️

written by Kopano.

👀 SEE ALSO 👀

kopano-archiver(8)

and that's the whole vibe check bestie 💖 this was Kopano 8, dated November 2016, served fresh from the KOPANO-ARCHIVER.CFG(5) era. go forth and archive responsibly, you absolute icon 🌈🦋🎀✨

📦 where this page comes from