diff --git a/app/views/docs/migrations-cloud-to-local.phtml b/app/views/docs/migrations-cloud-to-local.phtml index 801d93c0e..743efb54b 100644 --- a/app/views/docs/migrations-cloud-to-local.phtml +++ b/app/views/docs/migrations-cloud-to-local.phtml @@ -1,5 +1,5 @@

- Moving to a self-hosted instance? We've got you covered. + If you're moving your projects from Appwrite Cloud to self-hosted, we've got you covered. Migrations makes it as easy as a couple clicks to move all of your Appwrite Cloud project data to a self-hosted instance.

diff --git a/app/views/docs/migrations-firebase.phtml b/app/views/docs/migrations-firebase.phtml index a8fdc3fed..c5d234175 100644 --- a/app/views/docs/migrations-firebase.phtml +++ b/app/views/docs/migrations-firebase.phtml @@ -1,7 +1,7 @@

Moving your project from Firebase to Appwrite? Appwrite Migrations can help you streamline the process. - + Here's what you need to know to get started.

@@ -16,10 +16,10 @@

Migrating to Appwrite from Firebase

- To begin migrating to Appwrite make sure to read the migration overview + To begin migrating to Appwrite make sure to read the migration overview and things to keep in mind sections above.

- +
  1. Create a new project and click on the Migrations tab. @@ -28,7 +28,7 @@ Click on the Create Migration button and select Firebase as your source.
  2. - Depending on where your Appwrite project is hosted, you'll need to use different methods to authorize with Firebase. + Depending on where your Appwrite project is hosted, you'll need to use different methods to authorize with Firebase. See the Cloud and Self-hosting sections for details.
  3. @@ -36,13 +36,15 @@
-

Appwrite Cloud

+

Migrate to Cloud

To simplify the migration process we have created an OAuth application that will allow you to sign in with Google and automatically discover your Firebase projects. Simply select the source project and follow the migration wizard.

-

Migrating to Appwrite Self-Hosted

+

After completing the migration wizard, migration will begin. Return to step 4 of the migration steps.

+ +

Migrating to Self-Hosted

If you are self-hosting Appwrite you will need to create a service account in your Firebase project and download the JSON file.

@@ -55,12 +57,117 @@ Click the gear icon to access your Project Settings.
  • - Click Service Accounts, then Generate New Private Key. Don't share this key with anyone! + Click on Service Accounts, then click on the Manage service account permissions link redirecting you to the Google Cloud Console.
  • - Once you've downloaded your private key, head back to Appwrite and click Manual Authentication. + Click on Create Service Account, give it a name, id and description you want, then click Continue.
  • - Upload the JSON private key and follow the wizard. + Next you'll be prompted to grant the service account roles. You need to grant the following roles.
    • - + + + + + + + + + + + + + + + + + +
    RoleReason
    Firebase ViewerRead access to your entire Firebase project including Database and Storage.
    Identity Toolkit ViewerRead access to your users including their hash config.
    +
  • If you prefer to create a custom role, you can use the following permissions.
    • + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    PermissionReason
    datastore.databases.getRead access to your Firestore database.
    datastore.databases.listRead access to your Firestore database.
    datastore.entities.getRead access to your Firestore database's documents.
    datastore.entities.listRead access to your Firestore database's documents.
    datastore.indexes.getRead access to your Firestore database's indexes.
    datastore.indexes.listRead access to your Firestore database's indexes.
    firebaseauth.configs.getRead access to your Firebase project's authentication configs.
    firebaseauth.configs.getHashConfigRead access to your Firebase project's authentication configs including hash salt.
    firebaseauth.configs.getSecretRead access to your Firebase project's authentication configs including secret.
    firebaseauth.users.getRead access to your Firebase project's users.
    identitytoolkit.tenants.getRead access to your Firebase project's users.
    identitytoolkit.tenants.listRead access to your Firebase project's users.
    storage.buckets.getRead access to your Firebase project's storage buckets.
    storage.buckets.listRead access to your Firebase project's storage buckets.
    storage.objects.getRead access to your Firebase project's storage objects.
    storage.objects.listRead access to your Firebase project's storage objects.
    +
  • + Click Done to create the service account. After that you'll be redirected back to the service accounts page. Select the service account you just created and click Keys. +
    • +
  • + Click Add Key and select Create new key. Select JSON as the key type and click Create. This will download a JSON file to your computer. +
    • +
  • + Upload the JSON file to Appwrite and follow the migration wizard. +
    • +
  • + After completing the migration wizard, migration will begin. Return to step 4 of the migration steps. +
    • + \ No newline at end of file diff --git a/app/views/docs/migrations-local-to-cloud.phtml b/app/views/docs/migrations-local-to-cloud.phtml index 5cfee4cb8..96cd51ec3 100644 --- a/app/views/docs/migrations-local-to-cloud.phtml +++ b/app/views/docs/migrations-local-to-cloud.phtml @@ -1,5 +1,5 @@

    - Making the move to Appwrite Cloud? We've got your back. + If you're moving your self-hosted projects to Appwrite Cloud, we've got your back. Migrations makes it as easy as a couple clicks to move all of your self-hosted project data to a Cloud instance.