@@ -1 +1,13 @@ | |||||
## Todo | |||||
* Login to your Bubble | |||||
* Go to "Devices" | |||||
* In the "Download Certificate" section, click "Mac OS X" | |||||
* In the file dialog, choose "Open With" and open with the app "Keychain Access" | |||||
* In the "Keychain Access" app, select "Certificates" from the "Category" list in the bottom left corner. | |||||
* Select the Certificate you just downloaded, it's name is the same as your Bubble's name | |||||
* Right-click on the Certificate and choose "Get Info" | |||||
* Toggle the arrow next to the "Trust" section to expand it | |||||
* In the top drop-down box which reads "When using this certificate:", select "Always Trust" | |||||
* Close the Certificate info dialog | |||||
* An authorization dialog will appear. Enter your Mac user name and password and click "Update Settings" to authorize the change. | |||||
* Close the "Keychain Access" application. | |||||
* Congratulations! You have successfully installed your Bubble certificate! |
@@ -10,5 +10,4 @@ | |||||
* On the next screen, click "Finish". | * On the next screen, click "Finish". | ||||
* A "Security Warning" dialog appears. Click "Yes". | * A "Security Warning" dialog appears. Click "Yes". | ||||
* You should now see a dialog with the message "The import was successful". Click "OK". | * You should now see a dialog with the message "The import was successful". Click "OK". | ||||
* Congratulations! You have successfully installed your Bubble certificate! |
@@ -5,20 +5,20 @@ | |||||
* Click or tap "Show VPN connection info" for your new Android device. A QR code will appear. | * Click or tap "Show VPN connection info" for your new Android device. A QR code will appear. | ||||
* On your Android device: | * On your Android device: | ||||
* Install the Wireguard from the Google Play Store: https://play.google.com/store/apps/details?id=com.wireguard.android | |||||
* Install the WireGuard from the Google Play Store: https://play.google.com/store/apps/details?id=com.wireguard.android | |||||
* Alternatively, if you have access to the F-Droid App Store, you can install from: https://f-droid.org/en/packages/com.wireguard.android/ | * Alternatively, if you have access to the F-Droid App Store, you can install from: https://f-droid.org/en/packages/com.wireguard.android/ | ||||
* Open the Wireguard app | |||||
* In the Wireguard app, tap "Add a tunnel". If you don't see "Add a tunnel", tap the Plus icon (+) in the top-right corner of the screen. | |||||
* Open the WireGuard app | |||||
* In the WireGuard app, tap "Add a tunnel". If you don't see "Add a tunnel", tap the Plus icon (+) in the top-right corner of the screen. | |||||
* Tap the "Create from QR code" button | * Tap the "Create from QR code" button | ||||
* You Android device will ask you to allow Wireguard to use your camera. Allow this. | |||||
* You Android device will ask you to allow WireGuard to use your camera. Allow this. | |||||
* A camera view will open. Scan the QR code shown on your other device. You'll be asked to provide a name for the tunnel. You can choose anything, but it's probably easiest to use the name of your Bubble. | * A camera view will open. Scan the QR code shown on your other device. You'll be asked to provide a name for the tunnel. You can choose anything, but it's probably easiest to use the name of your Bubble. | ||||
* A new connection will now appear in Wireguard. Tap the toggle control to turn it on. | |||||
* A new connection will now appear in WireGuard. Tap the toggle control to turn it on. | |||||
* You'll now see a pop-up titled "Connection Request". Tap "OK" to allow the connection. | * You'll now see a pop-up titled "Connection Request". Tap "OK" to allow the connection. | ||||
* To ensure your device always remains connected to your Bubble, open the "Settings" app on your Android device | * To ensure your device always remains connected to your Bubble, open the "Settings" app on your Android device | ||||
* Tap "Connections" | * Tap "Connections" | ||||
* Tap "More Connection Settings" | * Tap "More Connection Settings" | ||||
* Tap "VPN" | * Tap "VPN" | ||||
* You should see your Wireguard VPN listed. Tap the gear icon to open its settings. | |||||
* You should see your WireGuard VPN listed. Tap the gear icon to open its settings. | |||||
* Tap the "Always-on VPN" toggle to enable always-on behavior | * Tap the "Always-on VPN" toggle to enable always-on behavior | ||||
* Optionally, also turn on the "Block connections without VPN" setting | * Optionally, also turn on the "Block connections without VPN" setting | ||||
* Congratulations! You are now connected to your Bubble's VPN! | * Congratulations! You are now connected to your Bubble's VPN! |
@@ -4,11 +4,11 @@ | |||||
* In the "Add Device" section, enter a name for your iOS device and click or tap the "Add" button to add it. | * In the "Add Device" section, enter a name for your iOS device and click or tap the "Add" button to add it. | ||||
* Click or tap "Show VPN connection info" for your iOS device. A QR code will appear. | * Click or tap "Show VPN connection info" for your iOS device. A QR code will appear. | ||||
* On your iPhone or iPad: | * On your iPhone or iPad: | ||||
* Install the Wireguard App from the Apple App Store: https://apps.apple.com/us/app/wireguard/id1441195209 | |||||
* Open the Wireguard app | |||||
* In the Wireguard app, tap "Add a tunnel". If you don't see "Add a tunnel", tap the Plus icon (+) in the top-right corner of the screen. | |||||
* Install the WireGuard App from the Apple App Store: https://apps.apple.com/us/app/wireguard/id1441195209 | |||||
* Open the WireGuard app | |||||
* In the WireGuard app, tap "Add a tunnel". If you don't see "Add a tunnel", tap the Plus icon (+) in the top-right corner of the screen. | |||||
* Tap the "Create from QR code" button | * Tap the "Create from QR code" button | ||||
* A camera view will open. Scan the QR code shown on your other device. You'll be asked to provide a name for the tunnel. You can choose anything, but it's probably easiest to use the name of your Bubble. | * A camera view will open. Scan the QR code shown on your other device. You'll be asked to provide a name for the tunnel. You can choose anything, but it's probably easiest to use the name of your Bubble. | ||||
* You'll now see a pop-up titled "Wireguard Would Like to Add VPN Configurations". Tap "Allow" and then enter your passcode | |||||
* You'll now see a pop-up titled "WireGuard Would Like to Add VPN Configurations". Tap "Allow" and then enter your passcode | |||||
* You'll now see your VPN connection listed. Tap the toggle switch to turn it on. | * You'll now see your VPN connection listed. Tap the toggle switch to turn it on. | ||||
* Congratulations! You are now connected to your Bubble's VPN! | * Congratulations! You are now connected to your Bubble's VPN! |
@@ -1,8 +1,8 @@ | |||||
* Install Wireguard by following the instructions for your Linux distribution at from: https://www.wireguard.com/install/ | |||||
* Install WireGuard by following the instructions for your Linux distribution at from: https://www.wireguard.com/install/ | |||||
* Login to your Bubble | * Login to your Bubble | ||||
* Navigate to the Devices screen | * Navigate to the Devices screen | ||||
* In the "Add Device" section, enter a name for your Linux system and click or tap the "Add" button to add it. | * In the "Add Device" section, enter a name for your Linux system and click or tap the "Add" button to add it. | ||||
* Click or tap "Show VPN connetion info" for your new Linux device. Click the button that reads "Download vpn.conf file" | |||||
* Click or tap "Show VPN connection info" for your new Linux device. Click the button that reads "Download vpn.conf file" | |||||
* After you have downloaded the file, as the root user, copy the file to `/etc/wireguard/wg0.conf` | * After you have downloaded the file, as the root user, copy the file to `/etc/wireguard/wg0.conf` | ||||
* As root, run `wg-quick up wg0` | * As root, run `wg-quick up wg0` | ||||
* Congratulations! You are now connected to your Bubble's VPN! | * Congratulations! You are now connected to your Bubble's VPN! |
@@ -1 +1,10 @@ | |||||
## Todo | |||||
* Download and install WireGuard from the Mac App Store: https://itunes.apple.com/us/app/wireguard/id1451685025?ls=1&mt=12 | |||||
* Login to your Bubble | |||||
* Navigate to the Devices screen | |||||
* In the "Add Device" section, enter a name for your Mac system and click or tap the "Add" button to add it. | |||||
* Click or tap "Show VPN connection info" for your new Mac device. Click the button that reads "Download vpn.conf file" | |||||
* Save the vpn.conf file to your computer. | |||||
* Open the WireGuard application if it is not already open. | |||||
* Click the "Import tunnel(s) from file" button, and select the vpn.conf file that you downloaded. | |||||
* Click the "Activate" button to connect to the VPN. | |||||
* Congratulations! You are now connected to your Bubble's VPN! |
@@ -1,14 +1,14 @@ | |||||
* Download and install Wireguard for Windows: https://download.wireguard.com/windows-client/wireguard-amd64-0.1.0.msi | |||||
* Download and install WireGuard for Windows: https://download.wireguard.com/windows-client/wireguard-amd64-0.1.0.msi | |||||
* Note: If you are running a 32-bit version of Windows, you must install the 32-bit version of Wireguard: https://download.wireguard.com/windows-client/wireguard-x86-0.1.0.msi | * Note: If you are running a 32-bit version of Windows, you must install the 32-bit version of Wireguard: https://download.wireguard.com/windows-client/wireguard-x86-0.1.0.msi | ||||
* Most newer Windows systems are 64-bit. To determine if your Windows is 64-bit or 32-bit, follow these instructions: https://www.lifewire.com/am-i-running-a-32-bit-or-64-bit-version-of-windows-2624475 | * Most newer Windows systems are 64-bit. To determine if your Windows is 64-bit or 32-bit, follow these instructions: https://www.lifewire.com/am-i-running-a-32-bit-or-64-bit-version-of-windows-2624475 | ||||
* Run the Wireguard msi installer that you just downloaded | |||||
* You will see a few warning dialogs to confirm that you really want to install Wireguard. Depending on the dialog, click "OK", "Run", "Yes", or "Install" to continue. | |||||
* Run the WireGuard msi installer that you just downloaded | |||||
* You will see a few warning dialogs to confirm that you really want to install WireGuard. Depending on the dialog, click "OK", "Run", "Yes", or "Install" to continue. | |||||
* Login to your Bubble | * Login to your Bubble | ||||
* Navigate to the Devices screen | * Navigate to the Devices screen | ||||
* In the "Add Device" section, enter a name for your Windows system and click or tap the "Add" button to add it. | * In the "Add Device" section, enter a name for your Windows system and click or tap the "Add" button to add it. | ||||
* Click or tap "Show VPN connetion info" for your new Windows device. Click the button that reads "Download vpn.conf file" | |||||
* Click or tap "Show VPN connection info" for your new Windows device. Click the button that reads "Download vpn.conf file" | |||||
* Save the vpn.conf file to your computer. | * Save the vpn.conf file to your computer. | ||||
* Open the Wireguard application if it is not already open. | |||||
* Open the WireGuard application if it is not already open. | |||||
* Click the "Import tunnel(s) from file" button, and select the vpn.conf file that you downloaded. | * Click the "Import tunnel(s) from file" button, and select the vpn.conf file that you downloaded. | ||||
* Click the "Activate" button to connect to the VPN. | * Click the "Activate" button to connect to the VPN. | ||||
* If a "Set Network Location" dialog appears, click on "Public network", then click the "Close" button. | * If a "Set Network Location" dialog appears, click on "Public network", then click the "Close" button. | ||||
@@ -0,0 +1,23 @@ | |||||
## Installing Wireguard | |||||
Connecting to your Bubble requires the WireGuard VPN app. | |||||
The process to download and install WireGuard depends on what type of device you have: | |||||
### Apple iOS devices | |||||
Install WireGuard from the (https://apps.apple.com/us/app/wireguard/id1441195209)[Apple App Store] | |||||
### Android devices | |||||
Install WireGuard from the (https://play.google.com/store/apps/details?id=com.wireguard.android)[Google Play Store] | |||||
or from the (https://f-droid.org/en/packages/com.wireguard.android/)[F-Droid Store] | |||||
### Windows systems | |||||
For 64-bit Windows systems, use the (https://download.wireguard.com/windows-client/wireguard-amd64-0.1.0.msi)[64-bit WireGuard MSI Installer]. | |||||
For 32-bit Windows systems, use the (https://download.wireguard.com/windows-client/wireguard-x86-0.1.0.msi)[32-bit WireGuard MSI Installer]. | |||||
### Mac OS X systems | |||||
Install WireGuard from the (https://itunes.apple.com/us/app/wireguard/id1451685025?ls=1&mt=12)[Mac App Store] | |||||
### Linux systems | |||||
Follow the instructions found on the (https://www.wireguard.com/install/)[WireGuard install page] for your Linux distribution. |