Remote Access with PiVPN
Log into your Pi
First, you will have to log in to a shell on your Raspberry Pi.
If you use macOS or Linux, open the Terminal app. Type
ssh firstname.lastname@example.org. When prompted for a password, enter the password (default
If you use Windows, download, install, and run PuTTY. Enter
octopi.local as the host name. Click open, and when prompted enter the username (default
pi) and the password (default
Run the PiVPN Installer
- First, update your package index files:
- Then, download and run the PiVPN installer:
curl -L https://install.pivpn.io | bash
- Follow the steps in the setup wizard. Use the tab key to navigate between options, and the spacebar to select them. When asked to choose a VPN server to install, choose ‘WireGuard’
You should now have a WireGuard server installed on your Raspberry Pi.
Setup WireGuard Client
- On your iOS device, download and install the WireGuard app from the App Store
- On your Raspberry Pi, run the
pivpn add command to create a client configuration. When prompted, enter a name for the client (e.g.
- Run the
pivpn -qr command. This will show a list of clients. Enter the ID of the client you want to show a setup QR code for. Resize the terminal window to show all the QR code if necessary.
- Open the WireGuard app on your phone. Tap the add (+) button, then tap ‘Create from QR code’. Scan the code shown in the terminal window.
- Turn the switch on. If you are asked to enter your device password to allow WireGuard to add VPN configurations, do so.
You should now be able to use Polymer remotely! Make sure to turn on the VPN each time first.