A Firebase project is a Google Cloud project that has some additional
Firebase-specific configurations and services enabled. This is commonly called
"adding Firebase" to a Google Cloud project. This page describes
[how to "add Firebase"](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#how-to-add-firebase), along with some
[frequently asked questions (FAQs)](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#faqs-and-troubleshooting).
When you add Firebase to a Google Cloud project, Firebase automatically enables
several APIs and creates service accounts to simplify the use of all Firebase
services and interfaces. Firebase also adds a
[`firebase:enabled` label](https://firebase.google.com/support/faq.md.txt#project-label-firebase-enabled)
to your project within the **IAM \& Admin** \>
[**Labels** page](https://console.cloud.google.com/iam-admin/labels)
of the Google Cloud console. Learn more details about
[what happens when you "add Firebase"](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#faq_what-happens-when-add-firebase).
## Relationship between a Firebase project and a Google Cloud project
Since a Firebase project ***is*** a Google Cloud project:
- You can access and interact with the project in the [Firebase console](https://console.firebase.google.com/)
as well as in the
[Google Cloud console](https://cloud.google.com/docs/overview/#google-cloud-console)
and
[Google APIs console](https://console.cloud.google.com/apis/).
- You can interact with the project using the
[Firebase CLI](https://firebase.google.com/docs/cli.md.txt), the
[gcloud CLI](https://cloud.google.com/sdk/gcloud),
and any Terraform resource from Google.
- You can use products and APIs from both Firebase and Google Cloud in the
project.
- [IAM permissions and roles](https://firebase.google.com/docs/projects/iam/overview.md.txt) for the project are
shared across Firebase and Google Cloud. Any access a project member (that is,
a principal) has to your Google Cloud project will also apply to your Firebase
project (and vice-versa).
- [Billing](https://firebase.google.com/pricing.md.txt) for the project is shared across Firebase and
Google Cloud. If billing is enabled on your Google Cloud project, then your
Firebase project will be on Firebase's pay-as-you-go Blaze pricing plan.
- Unique identifiers for the project (like
[project number](https://firebase.google.com/docs/projects/learn-more.md.txt#project-number) and
[project ID](https://firebase.google.com/docs/projects/learn-more.md.txt#project-id))
are shared across Firebase and Google Cloud.
- Any
[resource hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy)
applied to your Google Cloud project (for example, organization, folders,
etc.) will also apply to your Firebase project.
- Deleting the project deletes it across Firebase and Google Cloud.
- Deleting or modifying a resource or data within the project applies across
Firebase and Google Cloud.
## How to add Firebase to an existing Google Cloud project
You can "add Firebase" to an existing Google Cloud project using any of the
following options. Make sure that you have the
[required permissions to add Firebase](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#faq_required-permissions-to-add-firebase)
to the Google Cloud project.
Be aware that once you "add Firebase" to an existing Google Cloud project, it
can't be undone (that is, you can't *fully* "remove Firebase" from the
Google Cloud project). Learn more in this
[FAQ](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#faq_remove-firebase-from-project).
> [!NOTE]
> **Note:** In order to access and use all capabilities of Firebase in a Google Cloud project, you need to accept the [Firebase Terms of Service](https://firebase.google.com/terms.md.txt). Learn more about the [requirement to accept Firebase Terms](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#faq_requirement-to-accept-firebase-terms).
>
> Later on this page, you can find other [FAQ and troubleshooting](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#faqs-and-troubleshooting) for "adding Firebase" to your Google Cloud project.
### Firebase console
1. Sign into the
[Firebase console](https://console.firebase.google.com/) with the
account that gives you access to the existing Google Cloud project.
2. Click the button to create a new Firebase project.
3. At the bottom of the page, click
**Add Firebase to Google Cloud project**.
4. In the text field, start entering the **project name** of the existing
project, and then select the project from the displayed list.
5. Click **Open project**.
6. If prompted, accept the [Firebase Terms](https://firebase.google.com/terms.md.txt).
7. Follow the on-screen instructions to "add Firebase" and set up a
Firebase project.
Note that enabling AI assistance in the Firebase console and
Google Analytics are both optional.
### Firebase CLI
1. If you haven't already,
[install the Firebase CLI](https://firebase.google.com/docs/cli.md.txt#install_the_firebase_cli).
2. [Log in](https://firebase.google.com/docs/cli.md.txt#sign-in-test-cli) with the same Google Account that
gives you access to the existing Google Cloud project.
3. Run the following command:
```
firebase projects:addfirebase
```
4. When prompted, select the existing Google Cloud project from the
displayed list.
> [!NOTE]
> **Note:** If you get a `403 PERMISSION_DENIED` error when trying to "add Firebase" to an existing Google Cloud project, it can mean that you don't have the [required permissions](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#faq_required-permissions-to-add-firebase) or that you haven't [accepted the Firebase Terms of Service](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#faq_requirement-to-accept-firebase-terms).
### REST API
1. Enable the
[Firebase Management API](https://console.cloud.google.com/apis/library/firebase.googleapis.com)
in the existing Google Cloud project.
2. Generate your API access token.
3. Enable Firebase services for the project by calling
[`projects.addFirebase`](https://firebase.google.com/docs/reference/firebase-management/rest/v1beta1/projects/addFirebase.md.txt).
Note that you'll need the resource name of your project to make this call.
For detailed instructions, see
[Add Firebase services to your project](https://firebase.google.com/docs/projects/api/workflow_set-up-and-manage-project.md.txt#add-firebase)
in the Firebase guide: "Set up and manage a Firebase project using the
Management REST API". Make sure to follow all the instructions in the
[Before you begin](https://firebase.google.com/docs/projects/api/workflow_set-up-and-manage-project.md.txt#before-you-begin)
section of that guide.
> [!NOTE]
> **Note:** If you get a `403 PERMISSION_DENIED` error when trying to "add Firebase" to an existing Google Cloud project, it can mean that you don't have the [required permissions](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#faq_required-permissions-to-add-firebase) or that you haven't [accepted the Firebase Terms of Service](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#faq_requirement-to-accept-firebase-terms).
### Terraform
1. Enable the Firebase Management API (`firebase.googleapis.com`) in the
existing Google Cloud project.
2. Enable Firebase services for the project using the
`google_firebase_project` resource.
For detailed information about using Firebase and Terraform, see
[Get started with Terraform and Firebase](https://firebase.google.com/docs/projects/terraform/get-started.md.txt).
> [!NOTE]
> **Note:** If you get a `403 PERMISSION_DENIED` error when trying to "add Firebase" to an existing Google Cloud project, it can mean that you don't have the [required permissions](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#faq_required-permissions-to-add-firebase) or that you haven't [accepted the Firebase Terms of Service](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#faq_requirement-to-accept-firebase-terms).
## FAQs and troubleshooting
#### Is accepting the Firebase Terms of Service required to start using Firebase?
In order to access and use all capabilities of Firebase in a
Google Cloud project, you need to accept the
[Firebase Terms of Service](https://firebase.google.com/terms.md.txt). You also need to accept the Firebase Terms
in order to "add Firebase" to an existing Google Cloud project.
**You only need to accept the Firebase Terms once for your Google Account** no
matter how many projects you have access to. When you accept the terms, you're
accepting them *for your Google Account* ; acceptance is *not* at the
project-level for all project members.
You can accept the Firebase Terms through the [Firebase console](https://console.firebase.google.com/) using any of
the following options. When prompted, accept the Terms. If you're not
prompted to accept the Firebase Terms, then you've already accepted them.
- Accept the Firebase Terms directly using the
[Terms acceptance workflow](https://console.firebase.google.com/?forceCheckTos=true).
- Create a new Firebase project using the Firebase console, and then accept
the Firebase Terms.
- Open an existing Firebase project in the Firebase console, and then
accept the Firebase Terms (for example,
someone has invited you to become a project member (that is, a principal)
on the project).
- Open an existing Google Cloud project in the Firebase console,
["add Firebase"](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#how-to-add-firebase_console)
to it, and then accept the Firebase Terms.
> [!NOTE]
> **Note:** Accepting the Firebase Terms is *not* possible using the Firebase CLI, REST API, or Terraform. It can only be done using the Firebase console using one of the options described above.
> [!IMPORTANT]
> **Important:** If you signed an offline variant of the Google Cloud Master Agreement for use of specified Firebase services under the same Google Cloud Platform Account, the [Firebase Terms](https://firebase.google.com/terms.md.txt) do not apply to your use of such Firebase services, and your offline terms govern your use of such Firebase services.
#### Which permissions are required to "add Firebase"?
To "add Firebase" to an existing Google Cloud project, a project member (that
is, a principal) must have the following IAM permissions:
- `firebase.projects.update`
- `resourcemanager.projects.get`
- `serviceusage.services.enable`
- `serviceusage.services.get`
The IAM roles of Editor and Owner contain these permissions by default.
#### Why is the Firebase console failing to load a list of my existing Google Cloud projects?
This FAQ is most often applicable if you're trying to "add Firebase" to an
existing Google Cloud project using the Firebase console *and you have
access to many thousands of Google Cloud projects*.
The Firebase console isn't built to load many thousands of Google Cloud
projects. Instead, we recommend
[using
the Firebase CLI, REST API, or Terraform to "add Firebase" to your
existing Google Cloud project](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project#how-to-add-firebase).
Also, you might want to review the FAQ
["Why isn't my Firebase project showing up in my list of Firebase projects?"](https://firebase.google.com/support/faq.md.txt#gcp-projects-not-loading-in-console)
#### Is adding the `firebase:enabled` label sufficient to add Firebase?
All Firebase projects have a
[`firebase:enabled` label](https://firebase.google.com/support/faq.md.txt#project-label-firebase-enabled) within
the **IAM \& Admin** \>
[**Labels** page](https://console.cloud.google.com/iam-admin/labels)
of the Google Cloud console.
However, just manually adding the `firebase:enabled` label to your list of
project labels does NOT enable Firebase-specific configurations and services for
your Google Cloud project. To do that, you need to
[add Firebase](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#how-to-add-firebase) using the Firebase console (or, for
advanced use cases, using the Firebase CLI, Firebase Management REST API, or
Terraform).
#### What happens when you "add Firebase" to an existing Google Cloud project?
A Firebase project is a Google Cloud project that has some additional
Firebase-specific configurations and services enabled. So, when you
"add Firebase" to an existing Google Cloud project, Firebase takes the following
actions to simplify the use of all Firebase services and interfaces:
- Adds the
[`firebase:enabled` label](https://firebase.google.com/support/faq.md.txt#project-label-firebase-enabled)
within the **IAM \& Admin** \>
[**Labels** page](https://console.cloud.google.com/iam-admin/labels)
of the Google Cloud console.
- Creates a "Browser" API key and auto-restricts it to the
[Firebase-related APIs](https://firebase.google.com/docs/projects/api-keys.md.txt#faq-required-apis-for-restricted-firebase-api-key).
- Creates the following service accounts:
- `service-PROJECT_NUMBER@gcp-sa-firebase.iam.gserviceaccount.com`
- `firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com`
- Enables the following APIs:
- App Engine Admin API
- Cloud Pub/Sub API
- Cloud Resource Manager API
- Cloud Runtime Configuration API
- Cloud Testing API
- Firebase Cloud Messaging API
- Firebase Dynamic Links API
- Firebase Hosting API
- Firebase Installations API
- Firebase Management API
- Firebase Remote Config API
- Firebase Remote Config Realtime API
- Firebase Rules API
- Identity Toolkit API
- Token Service API
#### Can I "remove Firebase" from a project?
After you "add Firebase" to an existing Google Cloud project, it can't be undone
(that is, you can't *fully* "remove Firebase" from the Google Cloud project).
The process of "adding Firebase" enables APIs and backend services that may be
used for other Google Cloud features. Disabling all these enabled services could
cause unexpected and unintended consequences due to dependencies.
However, if you choose, it is possible for you to manually disable all the APIs
and delete the label, API key, and service accounts
[automatically enabled and created when you "added Firebase"](https://firebase.google.com/docs/projects/use-firebase-with-existing-cloud-project.md.txt#faq_what-happens-when-add-firebase).
> [!WARNING]
> **Warning:** If you choose to manually disable and delete what happened during "add Firebase", do so with extreme caution. You need to be absolutely sure that your Google Cloud project and apps associated with the project are not using *anything* related to what you're disabling and deleting; otherwise your project or app could stop working or behave in unexpected ways.
#### Can I block "adding Firebase" for an existing Google Cloud project?
While you can't actually block the possibility of "adding Firebase" to an
existing Google Cloud project, you can do the following:
Limit the project members (that is, principals) that have the IAM
permission `firebase.projects.update`, which is required to "add Firebase".
## Next steps
- Check out the following resources for learning more about Firebase projects:
- [Understand Firebase projects](https://firebase.google.com/docs/projects/learn-more.md.txt) ---
provides brief overviews of several important concepts about Firebase
projects, including their relationship with Google Cloud and the basic
hierarchy of a project and its apps and resources.
- [General best practices for setting up Firebase projects](https://firebase.google.com/docs/projects/dev-workflows/general-best-practices.md.txt) ---
provides general, high-level best practices for setting up Firebase projects
and registering your apps with a project so that you have a clear
development workflow that uses distinct environments.
- Get started using Firebase in your mobile and web apps by registering your
apps with your Firebase project and connecting them to Firebase:
[iOS+](https://firebase.google.com/docs/ios/setup.md.txt) \|
[Android](https://firebase.google.com/docs/android/setup.md.txt) \|
[Web](https://firebase.google.com/docs/web/setup.md.txt) \|
[Flutter](https://firebase.google.com/docs/flutter/setup.md.txt) \|
[Unity](https://firebase.google.com/docs/unity/setup.md.txt) \|
[C++](https://firebase.google.com/docs/cpp/setup.md.txt).