For the complete documentation index, see llms.txt. This page is also available as Markdown.

Download NetBird (QubitVPN Client)

Desktops/Laptops

Windows
1

Download and run Windows Installer

Install the version appropriate for your archeticture. Most modern computers run on 64-Bit.

64-Bit

ARM64

64-Bit (MSI)

ARM64 (MSI)

2

Enter Management URL to connect to the QubitVPN Network

Method 1:

  1. During setup, choose "Self Hosted" and then enter the following Management URL:

https://vpn.qubitvpn.com

Method 2:

  1. Click the 3 stacked dots (⋮) on the top right.

  2. Open Settings

  3. In the General tab under "Connection", choose Self-hosted and enter the following Management Server:

https://vpn.qubitvpn.com
3

Click on "Connect" from the NetBird icon in your system tray

4

Sign up/Log In using your Splicate/QubitVPN account

macOS
1

Download and run macOS Installer

macOS Universal Installer

2

Click on "Settings" then "Advanced Settings" from the NetBird icon in your system tray and enter the following "Management URL"

https://vpn.qubitvpn.com
3

Click on "Connect" from the NetBird icon in your system tray

4

Sign up/Log In using your Splicate/QubitVPN account


Mobile Phones

iOS
1

Download and install the application on the App Store:

Download on the App Store

2

Click on "Change Server" and enter the following "Server"

https://vpn.qubitvpn.com
3

Click on the "Connect" button in the middle of the screen

4

Sign up/Log In using your Splicate/QubitVPN account

Android
1

Download and install the application from the Google Play Store

Download on the App Store

2

Click on "Change Server" and enter the following "Server"

https://vpn.qubitvpn.com
3

Click on the "Connect" button in the middle of the screen

4

Sign up/Log In using your Splicate/QubitVPN account


Linux

Linux

Install with Command-line

Run NetBird and log in the browser


Smart TV

tvOS (Apple)

The tvOS app supports all Apple TV devices running tvOS 17.0 or later. It's available to download in the Apple TV app store.

tvOS support is currently in beta.

Configure NetBird on tvOS

1

First Launch

tvos-confirm-add-vpn-config

Upon first launch, NetBird will request permission to create a new VPN configuration. Select 'Allow' to continue.

2

Management Server Configuration

Navigate to 'Settings > Change Server', and the app will warn you that changing management server settings will erase your current config and disconnect if a connection is currently active:

tvos-confirm-change-server

After confirming, you'll be presented with a dialog to enter the management server URL. Please enter https://vpn.qubitvpn.com:443.

Select 'Change' to apply your new management server config. NetBird will run a brief verification step on the details you've entered, after which you can move on to connecting.

3

Connecting & Authenticating

On the main 'Connection' screen, select the 'Connect' button to initiate a connection to the QubitVPN network.

You will be presented a QR code and device ID:

tvos-authentication

Scan the QR code with a mobile device and you'll be able to sign in there. If asked to confirm your device code, confirm that the code underneath the QR code matches the one presented by the Splicate Authentication. Once you've completed the SSO flow, after a few seconds the authentication dialog in the NetBird app will automatically dismiss itself. Select the 'Connect' button once more, and your device should now be connected!

tvos-main-screen-connected
Google TV / Android TV
1

Where to Download

NetBird has an official Android application that you can download at the Google Play Store:

playstore

APK releases are also available to install directly on your Android device via the NetBird Android GitHub repository.

2

Configure Netbird on Android TV

Upon first launch, NetBird will inform you that it's using the default management server.

firstinstall

Select 'Continue' to acknowledge and you'll be greeted with the app's main screen.

android-tv-main-screen

3

Management Server Configuration

Select the hamburger menu on the top left of the main screen (or hold the left directional button) and navigate to the 'Change Server' menu.

android-tv-main-menu

Changing servers erases the device's current NetBird config, so you'll need to confirm the action before proceeding:

confirm-erase-cponfig

Enter QubitVPN's management server endpoint: https://vpn.qubitvpn.com:443.

Select 'change' to apply your new management server config, and if successful you'll see the following:

serverchanged

You're now ready to connect to the network!

4

Connecting to the Network

Select the NetBird logo button to connect. The app will request permission to create a VPN connection:

vpnconnectionrequest

Select 'OK'. You will then need to authenticate. NetBird will open a browser window where you'll be instructed to sign in.

After logging in, NetBird will confirm your authentication. Once you close the browser window, your device should be connected!

5

Authenticating

Since Android TV doesn't ship with a built-in browser, and entering credentials with a remote may be less than ideal, the TV client uses a slightly different authentication flow to the mobile app. After you grant the app permission to create a VPN connection, you'll be presented a QR code and device ID:

tvssoqr

Scan the QR code with your phone and you'll be able to sign in there. If asked to confirm your device code, confirm that the code underneath the QR code matches the one presented after Login. Once you've completed the SSO flow, the QR code dialog in the NetBird app will automatically dismiss itself, and your device should now be connected!

After installing, please check out the "How to Use" documentation:

How to use

Last updated