diff --git a/cert_instructions/macosx_cert.md b/cert_instructions/macosx_cert.md index 4e84d1b..42d1d24 100644 --- a/cert_instructions/macosx_cert.md +++ b/cert_instructions/macosx_cert.md @@ -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! diff --git a/cert_instructions/windows_cert.md b/cert_instructions/windows_cert.md index 7223731..371b11c 100644 --- a/cert_instructions/windows_cert.md +++ b/cert_instructions/windows_cert.md @@ -10,5 +10,4 @@ * On the next screen, click "Finish". * A "Security Warning" dialog appears. Click "Yes". * You should now see a dialog with the message "The import was successful". Click "OK". - - \ No newline at end of file + * Congratulations! You have successfully installed your Bubble certificate! diff --git a/vpn_instructions/android_vpn.md b/vpn_instructions/android_vpn.md index 10acad8..b8eb61f 100644 --- a/vpn_instructions/android_vpn.md +++ b/vpn_instructions/android_vpn.md @@ -5,20 +5,20 @@ * Click or tap "Show VPN connection info" for your new Android device. A QR code will appear. * 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/ - * 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 - * 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 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. * To ensure your device always remains connected to your Bubble, open the "Settings" app on your Android device * Tap "Connections" * Tap "More Connection Settings" * 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 * Optionally, also turn on the "Block connections without VPN" setting * Congratulations! You are now connected to your Bubble's VPN! diff --git a/vpn_instructions/ios_vpn.md b/vpn_instructions/ios_vpn.md index e333267..c3b371d 100644 --- a/vpn_instructions/ios_vpn.md +++ b/vpn_instructions/ios_vpn.md @@ -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. * Click or tap "Show VPN connection info" for your iOS device. A QR code will appear. * 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 * 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. * Congratulations! You are now connected to your Bubble's VPN! diff --git a/vpn_instructions/linux_vpn.md b/vpn_instructions/linux_vpn.md index a7139f4..6ab5fd8 100644 --- a/vpn_instructions/linux_vpn.md +++ b/vpn_instructions/linux_vpn.md @@ -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 * 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. - * 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` * As root, run `wg-quick up wg0` * Congratulations! You are now connected to your Bubble's VPN! diff --git a/vpn_instructions/macosx_vpn.md b/vpn_instructions/macosx_vpn.md index 70784b5..8ec214b 100644 --- a/vpn_instructions/macosx_vpn.md +++ b/vpn_instructions/macosx_vpn.md @@ -1 +1,10 @@ -## Todo \ No newline at end of file + * 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! diff --git a/vpn_instructions/windows_vpn.md b/vpn_instructions/windows_vpn.md index efef98d..4072476 100644 --- a/vpn_instructions/windows_vpn.md +++ b/vpn_instructions/windows_vpn.md @@ -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 * 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 * 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. - * 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. - * 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 "Activate" button to connect to the VPN. * If a "Set Network Location" dialog appears, click on "Public network", then click the "Close" button. diff --git a/wg_setup/README.md b/wg_setup/README.md new file mode 100644 index 0000000..3aecb91 --- /dev/null +++ b/wg_setup/README.md @@ -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.