jonhiggs / osxvpncli

A wrapper to help you start and stop your VPN connections from the command line.

osxvpncli

This is a wrapper to help you start and stop your macOS VPN connections from the command line.

Installation

The easiest method is via homebrew:

    $ brew tap jonhiggs/homebrew-osxvpncli
    $ brew install osxvpncli
    $ osxvpncli --help

Alternatively you can just clone the git repository to your local system:

    $ git clone https://github.com/jonhiggs/homebrew-osxvpncli.git <my_path>
    $ <my_path>/osxvpncli --help

Setup

Before you can do anything, you must first create the VPN connections that you wish to manipulate though System Preferences -> Network.

If you would like working tab-completion, you can use the completion script in bash_completion.d/osxvpncli. If you're not sure how to use bash_completion scripts, take a look at this blog post.

Usage

Usage:
  osxvpncli [OPTION] [vpn_name]

Options:
  connect     <vpn_name>  Establish a new connection
  disconnect  [vpn_name]  Terminate established connections
  status      [vpn_name]  Show connection status

Change Log

Version 0.2.2

• Renamed vpn to osxvpncli to avoid being overly rude with namespace.
• Document installation with homebrew.

Version 0.2.1

• Disconnect all if connection isn't supplied. #issue 5

Version 0.2

• Remove support for OS X Yosemite.
• Refactor for simpler code