openvpn3-session-manage(1)

💖 NAME 💖

openvpn3-session-manage — it's the OpenVPN 3 Linux VPN session management bestie, and she's here to actually wrangle your running sessions 💅

---

✨ SYNOPSIS ✨

openvpn3 session-manage [OPTIONS]
openvpn3 session-manage -h | --help

---

🌸 DESCRIPTION 🌸

okay so listen. this command manages running VPN sessions. that's the whole job. if you've got a session up and running and you need to pause it, resume it, restart it, yeet it into the void, or just peek at its logs — this is the girl you call. 🫶

---

👑 OPTIONS 👑

• -h, --help — prints usage and help details straight to your terminal, no cap. when in doubt, ask her. ✨
• -o SESSION-DBUS-PATH, --path SESSION-DBUS-PATH — Required. this is the D-Bus session path for the currently running session you wanna manage. don't know it? run openvpn3 sessions-list and she'll hand you the list of available session D-Bus paths. periodt. 💅
• --session-path DBUS-PATH — literally just an alias for --path. same girl, different name. 🙈
• -c CONFIG-NAME, --config CONFIG-NAME — you can use this instead of --path if you'd rather name the configuration profile directly. it's giving ✨convenience✨. the CONFIG_NAME has to be the configuration name that was active when the session was started — no negotiating on that. you can find the available configuration names via openvpn3 sessions-list. 🔍
• -I INTERFACE, --interface INTERFACE — another --path stand-in! this time you give the tun interface name that's managed by OpenVPN 3. iconic. 🌈
• --log-level[=LEVEL] — view and/or change the log level for this session. the way it works: it has an instant impact on the log level the next time new log events roll in from the VPN session. if you don't hand over a new log level, she'll just show you the current one. lowkey a vibe check for your logs. 📋
• --timeout SECS — sets how long she'll attempt to re-establish the connection when you're restarting or resuming a session. default? never time out — she's patient like that. and if you don't provide a timeout at all, the connection re-establishing happens in the background. run it in the back, bestie. 🏃♀️
• -P, --pause — suspends/pauses the running VPN session. 🛑 not a complete shutdown, okay? it's the "brb gonna temporarily disconnect but I fully intend to re-establish the VPN tunnel later" move. and the best part — in most cases you won't need to re-enter any credentials. obsessed. 💖
• -R, --resume — resumes a suspended/paused VPN session. she's back, she's refreshed, she's glowing. 🦋
• --restart — triggers a complete reconnect of the VPN session. full reset energy. 🔥
• -D, --disconnect — this is the final connection disconnect. it removes the session from the session manager. you can also use this to clean up stray VPN sessions that didn't complete successfully on their own — no judgment, we've all been there. and once you're disconnected, if connection statistics are available, she'll print them to the terminal for you. 📊
• --cleanup — removes all stale sessions that have no VPN client backend process running. heads up: these sessions typically have no status available. it's giving ghost cleanup. 💀✨

---

🎀 SEE ALSO 🎀

• openvpn3(1)
• openvpn3-session-acl(1)
• openvpn3-session-manage(1)
• openvpn3-session-stats(1)
• openvpn3-sessions-list(1)

---

and that's the whole page, bestie! this was openvpn3-session-manage(1) from the OpenVPN 3 Linux manual — go forth and manage your sessions responsibly, iykyk 🌸💜