openvpn3-service-sessionmgr(8)

📦
version 27.1 · 5 versions
, in ubuntu stonking

💖 openvpn3-service-sessionmgr — the OpenVPN 3 Linux Session Manager Service 💖

okay bestie, this is the openvpn3-service-sessionmgr(8) page from the OpenVPN 3 Linux manual, and it's literally the backstage crew keeping your VPN sessions alive. let's get into it 🎀

✨ NAME ✨

openvpn3-service-sessionmgr — the OpenVPN 3 Linux Session Manager Service 💅

🌸 SYNOPSIS 🌸

openvpn3-service-sessionmgr [OPTIONS]
openvpn3-service-sessionmgr -h | --help

🦋 DESCRIPTION 🦋

so openvpn3-service-sessionmgr is a backend service for OpenVPN 3 Linux, and its whole job — its main character era, fr — is managing running OpenVPN sessions. once a VPN session has been started, whether that's via openvpn3 session-start or openvpn2, it runs in the background as a D-Bus service for as long as it has at least one active VPN session running. no cap. ✨

only ONE session manager process can run on the system. like, one. that's it. 💀

your VPN sessions get managed through the openvpn3 session-manage and openvpn3 session-acl commands, and brand-new VPN sessions get started with the openvpn3 session-start command. that's the trio 🫶

this service is normally started automatically when it's needed, via the net.openvpn.v3.sessionmgr.service auto-start configuration handled by dbus-daemon(1), but you can also start it manually on the command line if that's your vibe. this process should run as the _openvpn user, and it will automatically switch to that user account if it has the privileges needed to do so. iconic behaviour honestly 👑

⚠️ beware though: changing this to another user account also requires updating the D-Bus policy as well. so don't just go rogue, bestie 😭

💜 OPTIONS 💜

  • -h, --help — print usage and help details to the terminal, so you know what's up 🙈
  • --version — prints the version of the program and exists 💫
  • --log-level LEVEL — sets the default log verbosity for log events generated by this service. the default is 3. valid values are 0 to 6. higher log levels result in more verbose logs, and log level 6 will contain all debug log events. so if you're nosy, that's your girl 🔥
  • --log-file LOG_DESTINATION — by default, logging goes via the openvpn3-service-log service. by providing this argument, logging will also be sent to LOG_DESTINATION, which can be either a filename or stdout: — where that last one sends log data to the console. multitasking queen 🌈
  • --colour — this adds colours to log events when logging to file or terminal. log events get coloured based on the log level of the event. cute AND functional, we love to see it 🎀
  • --idle-exit MINUTES — the openvpn3-service-sessionmgr service will exit automatically if it's been idle for MINUTES minutes. and by "idle" it means no VPN sessions are running and managed by this service. you can validate this by running openvpn3 sessions-list. if that gives you an empty list, no configuration profiles are being managed. bye bestie, see you never (until you're needed again) 👋

🌟 SEE ALSO 🌟

and that's the whole thing, bestie 💖 this was openvpn3-service-sessionmgr(8) from the OpenVPN 3 Linux manual — go forth and manage those sessions, you absolute legend 👑✨

📦 where this page comes from