Home Downloads Install FAQ Web App Donate

Video Guide

If you would like to follow a video demonstration, the Youtuber, HowToMen, has made a fantastic video detailing the installation process. It is slightly outdated, so if you have any issues with your install join our Discord and we can offer personalized help!

References

BlueBubbles Server Wiki
BlueBubbles Android / Desktop / Web Wiki
Private API setup instructions (for sending reactions / replies / effects, viewing typing indicators, etc)

Server Installation

Step 1/14

1.) On the device you wish to use as your server, go to our server GitHub downloads page.

Click the "BlueBubbles-x.x.x.dmg" file to download it.

2.) Open the .dmg file and drag BlueBubbles into your applications folder, then run BlueBubbles.

3.) Open the System Preferences app, select Security and Privacy, then give BlueBubbles full disk access.

Accessibility access is not required but might be needed for certain functions.

4.) Enter a strong password for your server. If you plan on port forwarding, you can change the proxy service dropdown to Dynamic DNS.

NOTE: If you plan on using Ngrok, please register for a free account on their website.

Once you have registered, go to "Your Authtoken".

Paste this string into the auth token field found in the BlueBubbles server settings. This helps prevent connection issues.

5.) Navigate to Google Firebase Console and login with your Google account.

6.) Create a new project titled "BlueBubblesApp".

7.) Click on Realtime Database > Create Database > Next > Enable

8.) Click on Project settings > Service accounts > Create Service Account > Generate a new private key, and save the file locally.

9.) Drag the private key we just downloaded into the FCM Server drop zone on the BlueBubbles application.

10.) From the Settings page click on the General tab, then click on the Android icon towards the bottom of the page.

11.) For package name enter com.<your name>.bluebubbles then click Register App and download the google-services.json file locally.

12.) Drag the google-services.json file into the FCM Client drop zone on the BlueBubbles application.

13.) Download any of our client applications, and scan the QR code or enter the URL and password to start syncing!

14.) Yay! You're connected!

Previous (1)

Next (2)