From 25d71c8635153526a3064f9508984848f86837e8 Mon Sep 17 00:00:00 2001 From: "Qays H. Poonawala" Date: Thu, 23 Jul 2026 09:51:11 -0700 Subject: [PATCH 1/4] Update manual Firestore setup instructions --- server/installation-guides/manual-setup.md | 26 +++++++++++++--------- 1 file changed, 16 insertions(+), 10 deletions(-) diff --git a/server/installation-guides/manual-setup.md b/server/installation-guides/manual-setup.md index 668e318..d134908 100644 --- a/server/installation-guides/manual-setup.md +++ b/server/installation-guides/manual-setup.md @@ -35,16 +35,22 @@ The name of the project does not have to be **BlueBubblesApp** if you already ha {% endhint %} 1. Click **Create a Project** and enter **BlueBubblesApp** as the name. Disable Google Analytics (why do you want Google spying on you?) and wait for the project to be created. -2. In the tabs on the far left, click **Build** > **Firestore Database.** -3. Next, **Create database** and press **Next > Enable.** You can change the database location if you are not based in North America so it is closer to you. -4. If Cloud Firestore glitches and does not show you the database page, simply refresh the page. -5. In the tabs near the top, click **Rules** -6. Set the rule's condition from `allow read, write: if false;` to `allow read, write: if true;` (Change false to true) and click **Publish**. -7. Click the gear cog in the top left and click **Project Settings**. -8. In the tabs near the top, navigate to **Service Accounts**. Generate a new private key and save this locally. **This will download file 1 / 2 needed for the manual setup.** -9. Next, navigate to the **General** tab. -10. Scroll to the bottom of the page and click the Android icon to add an Android app. Set the package name to `com.bluebubbles.messaging` and leave the other fields blank. -11. Click **Register app**, then **Download google\_services.json**. **This will download file 2 / 2 needed for the manual setup.** +2. Open the navigation menu and select **Databases** > **Firestore**. Depending on which console layout Google shows you, this may instead appear as **Build** > **Firestore Database**. +3. Click **Create database**. +4. On the **Create database** page: + * Leave the **Database ID** set to `(default)`. + * Select **Standard Edition**. + * Select **Firestore in Native mode**. + * Select **Restricted** security rules. You will update these rules in the next steps. + * Choose a region or multi-region close to the Mac running BlueBubbles, then click **Create Database**. +5. If Cloud Firestore does not show the database page after creation, refresh the page. +6. In the tabs near the top, click **Rules**. +7. Set the rule's condition from `allow read, write: if false;` to `allow read, write: if true;` (Change false to true) and click **Publish**. +8. Click the gear cog in the top left and click **Project Settings**. +9. In the tabs near the top, navigate to **Service Accounts**. Generate a new private key and save this locally. **This will download file 1 / 2 needed for the manual setup.** +10. Next, navigate to the **General** tab. +11. Scroll to the bottom of the page and click the Android icon to add an Android app. Set the package name to `com.bluebubbles.messaging` and leave the other fields blank. +12. Click **Register app**, then **Download google\_services.json**. **This will download file 2 / 2 needed for the manual setup.** {% endtab %} {% tab title="Video Guide" %} From 513f150d8320e4a08019bbd5879e4f86da882546 Mon Sep 17 00:00:00 2001 From: "Qays H. Poonawala" Date: Thu, 23 Jul 2026 15:04:51 -0700 Subject: [PATCH 2/4] docs: align Firestore setup labels --- server/installation-guides/manual-setup.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/server/installation-guides/manual-setup.md b/server/installation-guides/manual-setup.md index d134908..60d608a 100644 --- a/server/installation-guides/manual-setup.md +++ b/server/installation-guides/manual-setup.md @@ -35,14 +35,15 @@ The name of the project does not have to be **BlueBubblesApp** if you already ha {% endhint %} 1. Click **Create a Project** and enter **BlueBubblesApp** as the name. Disable Google Analytics (why do you want Google spying on you?) and wait for the project to be created. -2. Open the navigation menu and select **Databases** > **Firestore**. Depending on which console layout Google shows you, this may instead appear as **Build** > **Firestore Database**. -3. Click **Create database**. +2. Open the navigation menu and select **Databases & Storage** > **Firestore**. Depending on which console layout Google shows you, this may instead appear as **Build** > **Firestore Database**. +3. Click **Create database**. If the project already has a Firestore database, this button is labeled **Add database** instead. 4. On the **Create database** page: - * Leave the **Database ID** set to `(default)`. - * Select **Standard Edition**. - * Select **Firestore in Native mode**. - * Select **Restricted** security rules. You will update these rules in the next steps. - * Choose a region or multi-region close to the Mac running BlueBubbles, then click **Create Database**. + * Leave the **Database ID** set to `(default)`, if this option is shown. + * Select **Standard edition**, if this option is shown. + * Select **Firestore in Native mode**, if this option is shown. + * Choose a region or multi-region close to the Mac running BlueBubbles. + * Select **Production mode** for the starting security rules. You will replace these rules in the next steps. + * Click **Create**. 5. If Cloud Firestore does not show the database page after creation, refresh the page. 6. In the tabs near the top, click **Rules**. 7. Set the rule's condition from `allow read, write: if false;` to `allow read, write: if true;` (Change false to true) and click **Publish**. From a90846cb0f4dd8d6bcfb3700a48aca34557b5c4e Mon Sep 17 00:00:00 2001 From: "Qays H. Poonawala" Date: Sat, 25 Jul 2026 14:38:47 -0700 Subject: [PATCH 3/4] docs: clarify Firestore location permanence --- server/installation-guides/manual-setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/server/installation-guides/manual-setup.md b/server/installation-guides/manual-setup.md index 60d608a..2af555e 100644 --- a/server/installation-guides/manual-setup.md +++ b/server/installation-guides/manual-setup.md @@ -41,7 +41,7 @@ The name of the project does not have to be **BlueBubblesApp** if you already ha * Leave the **Database ID** set to `(default)`, if this option is shown. * Select **Standard edition**, if this option is shown. * Select **Firestore in Native mode**, if this option is shown. - * Choose a region or multi-region close to the Mac running BlueBubbles. + * Choose a region or multi-region close to the Mac running BlueBubbles. This location cannot be changed after the database is created, so review the selection before continuing. * Select **Production mode** for the starting security rules. You will replace these rules in the next steps. * Click **Create**. 5. If Cloud Firestore does not show the database page after creation, refresh the page. From e8a1a79536879627b8ca52903d6d02c5fee2581d Mon Sep 17 00:00:00 2001 From: "Qays H. Poonawala" Date: Mon, 27 Jul 2026 23:48:24 -0700 Subject: [PATCH 4/4] docs: preserve manual setup step anchors --- server/installation-guides/manual-setup.md | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/server/installation-guides/manual-setup.md b/server/installation-guides/manual-setup.md index 2af555e..ec7a9e5 100644 --- a/server/installation-guides/manual-setup.md +++ b/server/installation-guides/manual-setup.md @@ -36,22 +36,21 @@ The name of the project does not have to be **BlueBubblesApp** if you already ha 1. Click **Create a Project** and enter **BlueBubblesApp** as the name. Disable Google Analytics (why do you want Google spying on you?) and wait for the project to be created. 2. Open the navigation menu and select **Databases & Storage** > **Firestore**. Depending on which console layout Google shows you, this may instead appear as **Build** > **Firestore Database**. -3. Click **Create database**. If the project already has a Firestore database, this button is labeled **Add database** instead. -4. On the **Create database** page: +3. Click **Create database**. If the project already has a Firestore database, this button is labeled **Add database** instead. On the **Create database** page: * Leave the **Database ID** set to `(default)`, if this option is shown. * Select **Standard edition**, if this option is shown. * Select **Firestore in Native mode**, if this option is shown. * Choose a region or multi-region close to the Mac running BlueBubbles. This location cannot be changed after the database is created, so review the selection before continuing. * Select **Production mode** for the starting security rules. You will replace these rules in the next steps. * Click **Create**. -5. If Cloud Firestore does not show the database page after creation, refresh the page. -6. In the tabs near the top, click **Rules**. -7. Set the rule's condition from `allow read, write: if false;` to `allow read, write: if true;` (Change false to true) and click **Publish**. -8. Click the gear cog in the top left and click **Project Settings**. -9. In the tabs near the top, navigate to **Service Accounts**. Generate a new private key and save this locally. **This will download file 1 / 2 needed for the manual setup.** -10. Next, navigate to the **General** tab. -11. Scroll to the bottom of the page and click the Android icon to add an Android app. Set the package name to `com.bluebubbles.messaging` and leave the other fields blank. -12. Click **Register app**, then **Download google\_services.json**. **This will download file 2 / 2 needed for the manual setup.** +4. If Cloud Firestore glitches and does not show you the database page, simply refresh the page. +5. In the tabs near the top, click **Rules** +6. Set the rule's condition from `allow read, write: if false;` to `allow read, write: if true;` (Change false to true) and click **Publish**. +7. Click the gear cog in the top left and click **Project Settings**. +8. In the tabs near the top, navigate to **Service Accounts**. Generate a new private key and save this locally. **This will download file 1 / 2 needed for the manual setup.** +9. Next, navigate to the **General** tab. +10. Scroll to the bottom of the page and click the Android icon to add an Android app. Set the package name to `com.bluebubbles.messaging` and leave the other fields blank. +11. Click **Register app**, then **Download google\_services.json**. **This will download file 2 / 2 needed for the manual setup.** {% endtab %} {% tab title="Video Guide" %}