Skip to content

Update manual Firestore database setup #31

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
zlshames merged 4 commits into from
Aug 13, 2026
Merged

Update manual Firestore database setup #31

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
25d71c8
Update manual Firestore setup instructions
qayshp Jul 23, 2026
513f150
docs: align Firestore setup labels
qayshp Jul 23, 2026
a90846c
docs: clarify Firestore location permanence
qayshp Jul 25, 2026
e8a1a79
docs: preserve manual setup step anchors
qayshp Jul 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions server/installation-guides/manual-setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,8 +35,14 @@ 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.
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. 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**.
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**.
Expand Down