openvpn3-as(1)

📦
version 27.1 · 3 versions
, in nixpkgs unstable, ubuntu stonking

💖 openvpn3-as — OpenVPN 3 Access Server Profile Downloader 💖

okay bestie, welcome to the openvpn3-as page from the OpenVPN 3 Linux manual set. this little icon grabs config profiles straight off an OpenVPN Access Server, and i'm gonna walk you through every single flag, no skips, no cap. 🫶

✨ SYNOPSIS ✨

openvpn3-as [ OPTIONS ] URL
openvpn3-as -h | --help

🌸 DESCRIPTION 🌸

so like, this utility can download a configuration profile directly from an OpenVPN Access Server. you give it a URL that points at the Access Server, and then it's gonna query you for authentication credentials before it even connects to the server. yes, it asks. yes, it needs them. that's the vibe. 💅

🎀 OPTIONS 🎀

  • -h, --help — shows this help message and then dips out (exits). classic.
  • --autologin — downloads the auto-login profile instead of the default user-login profile. the glow-up here: the auto-login profile will not ask the user for credentials before connecting to the Access Server. but not me warning you — this feature may not be available for all user profiles. 🙈
  • --systemd-start — starts the downloaded profile automatically right after downloading it, using the systemd openvpn3-sessions@.service unit file. see the openvpn3-systemd(1) man page for the deets. turning this on will also start this unit file at boot. ⚠️ this requires openvpn3-as to be run as root.
  • --impersistent — do not import the configuration profile as a persistent profile (default is persistent, so this is the "actually don't keep it" option).
  • --name CONFIG-NAME — overrides the automatically generated profile name. the default auto-name is AS:$servername, so if you want something cuter (or just something you'll actually remember), this is your moment. ✨
  • --owner USERNAME — transfers ownership of the downloaded configuration profile to USERNAME. ⚠️ this requires openvpn3-as to be run as root. super useful when you're using it together with --systemd-start. 🫶
  • --username USERNAME — the username to use for OpenVPN Access Server login 🔑
  • --insecure-certs — accepts invalid and potentially insecure TLS server certificates. this is typically needed when the Access Server uses a self-signed certificate, or one issued by a Certificate Authority that the system doesn't know about. > bestie, use this feature carefully. it's literally in the manual that you should. 💀

👑 SEE ALSO 👑

openvpn(8) openvpn3(1) openvpn3-config-manage(1) openvpn3-configs-list(1)

and that's the page, periodt. 🦋 this was openvpn3-as(1) from the OpenVPN 3 Linux docs — go download yourself a profile and slay. 💖🌈⭐

📦 where this page comes from