KOPANO-ICAL(8)

📦 version 8.7.0, in ubuntu jammy

✨ NAME ✨

kopano-ical — bestie, this is the one that starts up your Kopano ICal/CalDAV gateway 💖 it's giving "calendar server, but make it serve".

🦋 SYNOPSIS 🦋

kopano-ical [OPTION...]

🌸 DESCRIPTION 🌸

Okay so. The iCal/CalDAV gateway is the little legend that lets your users pull their calendar down with any iCalendar-compliant client. No cap. And because it's a generous icon, it can be configured to listen for both HTTP and HTTPS requests. 💅

Where do all its default settings live, you ask? In kopano-ical.cfg(5). That's the blueprint, that's the vibe, that's where defaults come from. ✨

🎀 OPTIONS 🎀

So many options are possible. And here's the tea: none of these options are required. You can just vibe with the defaults, fr fr.

  • --config, -c ical.cfg — tell it where the ical.cfg file lives. And if you don't specify an ical.cfg file at all? The gateway just keeps on using its default settings, unbothered, moisturized, in its lane. 🫶

Default: /etc/kopano/ical.cfg

  • --dump-config — spills the values of gateway.cfg configuration parameters and the implied defaults. A full reveal, no secrets. 👑
  • --help, -h — shows you the help message of the iCal/CalDAV gateway. Your little bestie who tells you how to use it. 🌈
  • --foreground, -F — run in the foreground. Because normally the gateway daemonizes and runs in the background, so this is the "no, stay here with me" option. 🙈

💀 SIGNALS 💀

Here are the signals you can send to the kopano-ical process. Choose wisely, they're all listening. ✨

HUP

When the HUP signal arrives, some options from the configuration file get reloaded. Which ones exactly? The reloadable ones are listed in the kopano-ical.cfg(5) manual page, so go check that list, iykyk. 📋

Also — and this is the cute part — when you're using log_method = file, the logfile gets closed and a brand new logfile gets opened. So you can use this signal inside your logrotate system. Rotate, slay, repeat. 🔥

TERM

To gracefully let the service exit, the normal TERM signal is used. A gentle goodbye, not a dramatic exit. 🥺

🌟 USAGE 🌟

To start the iCal/CalDAV gateway, just:

kopano-ical

The iCal/CalDAV gateway process will keep running. Like, it's committed. Main character energy, honestly. 💜

You may also use the init.d scripts:

/etc/init.d/kopano-ical [start| stop| restart]

(Yes, the spacing is exactly like that. We don't question it, we respect it. 🙈)

👑 AUTHOR 👑

Written by Kopano. Periodt.

🧚 SEE ALSO 🧚

And that's a wrap, bestie! This lil page is from Kopano 8, dated November 2016 — vintage, iconic, still serving 💖 mwah, go start your gateway 🦋✨

📦 where this page comes from