← 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. Type your user name or email address. A 6-digit code arrives by email from signin@binaryparry.com; type it in (administrators then also enter their authenticator code). The browser shows Access granted and you can close the tab. OpenVPN Connect shows Connected. Finish within 5 minutes of connecting, or start again.
  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, Debian, and systems built on Ubuntu such as Linux Mint and Pop!_OS (the repository line fills in your release's name, e.g. jammy, noble, resolute, bookworm, trixie, so the packages match your system):

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 $(. /etc/os-release && echo ${UBUNTU_CODENAME:-$VERSION_CODENAME}) main" | sudo tee /etc/apt/sources.list.d/openvpn3.list
sudo apt update
sudo apt install openvpn3-client

If sudo apt update says the OpenVPN repository "does not have a Release file", your release is too new or too old for OpenVPN's packages yet: tell the owner which system you use.

Fedora:

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

Rocky Linux and AlmaLinux 8, 9 or 10 (the packages need EPEL; on Red Hat Enterprise Linux itself, set up EPEL as its own page at https://docs.fedoraproject.org/en-US/epel/ says, then run the last two lines):

sudo dnf install epel-release dnf-plugins-core
sudo dnf copr enable dsommers/openvpn3
sudo dnf install openvpn3-client

Arch Linux: the openvpn3 package in the AUR (community-maintained), e.g. yay -S openvpn3.

Any other system: ask the owner before you try something else. Its built-in VPN settings can't do the browser sign-in.

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 with your user name or email address and the code from your email, within 5 minutes. 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