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
- An account. There is no sign-up: the platform owner invites you. You get an email with an invitation link; opening it sends a code to the same address, and typing that code sets up your account. The link works once and expires, so use it soon. There is no password.
- The profile. The owner sends you
sane-pt.ovpn. It is the same file for everyone and holds no password or personal key. - A VPN app that can sign in through the browser: OpenVPN Connect on Windows and macOS, or OpenVPN 3 on Linux (below).
2a. Windows and macOS: OpenVPN Connect
- Download and install OpenVPN Connect from
https://openvpn.net/client/. - 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. - Turn the profile's switch on to connect. Your browser opens the SANE-PT sign-in page at
auth.binaryparry.com. - 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. - 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
- "Access denied" with an Error ID. Send the owner the Error ID shown at the bottom of the page; it points to the reason in the server's log.
- Open the sign-in link on the computer that is connecting. The server checks that the browser and the VPN app come from the same internet address, so a link opened on your phone is refused.
- "This account can't sign in with an email code", or no access. Your account may be switched off, have no email address, or not yet be allowed on the VPN: ask the owner.
- No code arrives. Codes usually come within a minute; look in your spam folder. A code is valid for 15 minutes, but the connection waits only 5: if it has given up, disconnect and connect again for a new code.
- How long a sign-in lasts. You stay connected for up to 8 hours (one working day) without signing in again. Your browser stays signed in for 7 days after a code, so a new connection in that time usually goes straight through in the same browser; after that, the browser asks for a new code.