← BinaryParry

Connect to SANE-PT

SANE-PT is only reachable through its VPN. Everyone uses the same VPN profile, sane-pt.ovpn; each time you connect, you sign in with your own SANE-PT account in your browser.

1. Before you start

2a. Windows and macOS: OpenVPN Connect

  1. Download and install OpenVPN Connect from https://openvpn.net/client/.
  2. Open it, choose Import Profile, then Upload File, and pick sane-pt.ovpn. Leave the user name and password fields as they are: nothing checks them.
  3. Turn the profile's switch on to connect. Your browser opens the SANE-PT sign-in page at auth.binaryparry.com.
  4. Sign in with your user name and password. The browser shows Access granted and you can close the tab. OpenVPN Connect shows Connected.
  5. To disconnect, turn the switch off.

2b. Linux: OpenVPN 3 (openvpn3)

Don't use the VPN settings of your desktop (NetworkManager's OpenVPN plugin): it can't do the browser sign-in, so the connection never comes up.

Install OpenVPN 3 from OpenVPN's repository. Ubuntu 24.04 (use your release's name in place of noble, e.g. jammy, bookworm):

sudo apt install apt-transport-https curl
sudo mkdir -p /etc/apt/keyrings
curl -sSfL https://packages.openvpn.net/packages-repo.gpg | sudo tee /etc/apt/keyrings/openvpn.asc >/dev/null
echo "deb [signed-by=/etc/apt/keyrings/openvpn.asc] https://packages.openvpn.net/openvpn3/debian noble main" | sudo tee /etc/apt/sources.list.d/openvpn3.list
sudo apt update
sudo apt install openvpn3-client

Fedora:

sudo dnf copr enable dsommers/openvpn3
sudo dnf install openvpn3-client

Import the profile once (it is kept across reboots):

openvpn3 config-import --config sane-pt.ovpn --name sane-pt --persistent

Connect:

openvpn3 session-start --config sane-pt

If no browser opens, it prints the sign-in link; open it in a browser on the same computer:

Web based authentication required.
Could not open the URL automatically.
Open this URL to complete the connection:
     https://vpn.binaryparry.com/oauth2/start?state=...

Sign in. The page shows Access granted. Check the connection, then disconnect when you're done:

openvpn3 sessions-list          # Status: Connection, Client connected
openvpn3 session-manage --config sane-pt --disconnect

Tray icon instead of commands: install openvpn3-indicator (Ubuntu: sudo add-apt-repository ppa:grzegorz-gutowski/openvpn3-indicator then sudo apt install openvpn3-indicator; Fedora: sudo dnf copr enable grzegorz-gutowski/openvpn3-indicator then sudo dnf install openvpn3-indicator). Click its icon to import sane-pt.ovpn, connect and disconnect; the sign-in opens in the browser as above.

3. Open SANE-PT

While connected, open http://10.8.0.1/app. You are signed in to SANE-PT as the account you used in the browser.

When something goes wrong