Tunnelbear VPN

An un-official Tunnelbear VPN client made with React, Electron, TypeScript, and Vite.

Get started by using Tunnelbear VPN linux client by downloading it from releases to secure your internet connections.

Table of contents

• What is Tunnelbear VPN?
• Breaking Changes
• How to use
• Contributors

What is Tunnelbear VPN?

"Tunnelbear VPN" is a public VPN service based on Toronto, Canada. Sadly, it only support Windows, Mac, Android, and iOS which led to no client app for GNU/Linux users. This project is solving that issue by creating a simple client that user can import which VPN config they want to use.

Breaking Changes

• Starting from "v1.1.0" user credentials now are encrypted using aes-js therefore, anyone who use any version before "v1.1.0" recommended to remove their localstorage data by purging the installations.

  Purging the installation can be done by using this command (the examples are ubuntu base only)

  sudo apt purge tunnelbear-vpn

How to use

To use this "un-official Tunnelbear VPN client", you need to do this following steps.

1. Download the prebuild client app from the releases page or build it by forking the repo.
2. Download the "Tunnelbear VPN OpenVPN Config" from the official blog posts or by downloading the config straight from their download link.

   The direct link are from the blog post that the Tunnelbear provide. If you are scared that it was a scam or something, you can just try to download it from the blog post that Tunnelbear provides.

3. Extract all the configs or extract which config that you want to a certain directory.

   Keep in mind that you cannot delete this directory since the app will save the directory locations for each the config that you are going to import.

4. Run/Launch the client and import the config files that you just extracts.
5. Configure the auth by clicking the "Configure Auth" button on the top bar.

   The app will keep your credentials on the localstorage so it can be used again if you decide to change your VPN connections profile. As stated previously, the credentials is stored in the localstorage of the client and is not being used to do any kind actions to take your account or anything.

6. Click to which VPN config that you want to connect and gave the sudo permissions.

   The client app is need to use sudo permissions to make an OpenVPN connections. No worries, this sudo only being use for creating a connections/disconnecting the OpenVPN connections.

7. Surf the internet while the bear securing your connections!.

Contributors

We 💖 contributors! Feel free to contribute to this project but please read the Contributing Guidelines before opening an issue or PR so you understand the branching strategy and local development environment.