Video Guide
If you would like to follow a video demonstration, the Youtuber, HowToMen, has made a fantastic video detailing the installation process
References
- Server Wiki: GitHub - BlueBubbles Server Wiki
- Android Wiki: GitHub - BlueBubbles Android Wiki
- Desktop Wiki: GitHub - BlueBubbles Desktop Wiki
- Private API Features: How to get Reactions & Typing Indicators
Server Installation
Step 1/14
1.) On the device you wish to use as your server, browse to our downloads page and select the MacOS Server download option.
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
as well as full accessibility.
4.) Enter a password for your server and keep NGROK enabled unless you plan on forwarding your local IP or dynamic DNS.
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 your server's QR code (screenshot to clipboard on Windows using Win + Shift + S) to start syncing your messages.
14.) Yay! You're connected!
Previous (1)
Next (2)