PPTPSETUP(8)

📦
version 1.10.0 · 10 versions
, in ubuntu resolute, ubuntu stonking

💅 NAME

okay so bestie, welcome to pptpsetup — the Point-to-Point Tunneling Protocol setup script. she's a little Perl icon in section 8 of the manual (that's the "system admin commands" section, iykyk), and she exists to set up your PPTP Client. 🎀

✨ SYNOPSIS ✨

pptpsetup --create <TUNNEL> --server <SERVER> [--domain <DOMAIN>]
          --username <USERNAME> [--password <PASSWORD>]
          [--encrypt] [--start]

pptpsetup --delete <TUNNEL>

note the square brackets, bestie — anything inside [ ] is optional, anything not is required. so --create, --server, and --username are the non-negotiables on the create path. 🫶

🌸 DESCRIPTION 🌸

PPTP Client is a Linux, FreeBSD, NetBSD and OpenBSD client for the proprietary Microsoft Point-to-Point Tunneling Protocol, PPTP. basically it's the thing that tunnels your traffic to a PPTP server. periodt.

this script configures PPTP Client on Linux. (just Linux, okay? don't come for me if you're on BSD — the client works there, but this script is a Linux girlie. 💅)

👑 OPTIONS 👑

  • --create TUNNEL — create a tunnel named TUNNEL. the main character move. ✨
  • --delete TUNNEL — delete the file /etc/ppp/peers/TUNNEL and any lines from /etc/ppp/chap-secrets that contains "TUNNEL" as a single word. it's giving cleanup, it's giving exfoliation. 🧖
  • --server SERVER — the IP address or host name of the server. yes bestie, IP or hostname, both slay.
  • --domain DOMAIN — the authentication domain name (optional). if your server wants a domain, this is her moment. 🌈
  • --username USERNAME — the username you are to use.
  • --password PASSWORD — the password you are to use. if you don't specify a password, pptpsetup will ask for one. so it's not shy, it will literally prompt you, no cap. 🙈
  • --encrypt — whether encryption is required. flag it if you require encryption.
  • --start — whether the connection should be started after configuration. like, right after setup, immediately, let's go. 🔥
pssst — every one of these is a long option with two dashes. no cute little short flags here, she's not about that life.

💖 AUTHOR 💖

Nelson Ferraz <nferraz at gmail.com>, based on James Cameron's PPTP Client Debian HOWTO. iconic lineage, honestly. 👑

🦋 SEE ALSO 🦋

go read them, they're the lore. iykyk. 📚

pptpsetup - Point-to-Point Tunneling Protocol setup

Copyright (C) 2006 Nelson Ferraz

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

lowkey important: that "without any warranty" bit is not a joke. no promises, bestie. fr fr. 💀

and that's the whole vibe check! this page is from perl v5.40.1, dated 2025-12-06, and it's living its best life under the name PPTPSETUP(8). mwah, go tunnel something. 💋🎀

📦 where this page comes from