DEV Community

Cover image for How to transfer your projects to Appwrite in one click
Odewole Babatunde Samson for Hackmamba

Posted on

How to transfer your projects to Appwrite in one click

Transferring projects using one click typically refers to moving digital projects—such as websites, applications, databases, or other software-related assets—seamlessly and with minimal manual intervention from one hosting environment to another. It's a standard process companies and engineering teams adopt when switching hosting providers, upgrading infrastructure, or deploying projects to different environments—a process that is useful in any step of the project from development to production.

The term "one-click" implies that migration can be initiated with a few actions, simplifying what can otherwise be a complex and time-consuming process. Migrations are often facilitated by specialized tools, services, or scripts that automate the transfer of files, databases, configurations, and other components.

Technology overview

Migration in Appwrite can help you migrate existing projects and move quickly to Appwrite. You can move your app from Firebase, Supabase, and Nhost and even between self-hosted and cloud projects using Migrations. You can also use Migrations to move between two self-hosted instances or duplicate projects on the same instance. Migrations will automatically move accounts, database documents, and storage files from one source to another.

Appwrite Cloud is an extension of the open-source version of Appwrite. It comes with all the services included in the open-source version but now has a fully managed service and minimum friction.

Project overview

This article will discuss migrating an existing Next.js and Supabase project that stores products in the Supabase database to the Appwrite cloud database.

GitHub

Check out the complete source code here.

Prerequisites

To follow along with this tutorial, you should have a working knowledge of the following:

  • Basic understanding of JavaScript
  • An Appwrite Cloud account; you can sign up for one here
  • A Supabase project; you can create one here

Setting up the product application

To set up your application, you'll clone this repository using the command below:

git clone <repo-git-url>
Enter fullscreen mode Exit fullscreen mode

Then, run the command below in the project directory:

$ cd <project-directory>
$ npm install
Enter fullscreen mode Exit fullscreen mode

This repository contains all the initial setups you'll need for your app, helping you focus on your app's main functionality.

Then, run the development server using the command below:

npm run dev
Enter fullscreen mode Exit fullscreen mode

Once the development server runs, you can view it on your browser at http://localhost:3000.

Note: You may run into some errors if you run the app as it is. This means you have to manually set your supabase project configuration and get the required credentials like the Endpoint and API Keys.

The product catalog app should look like this:

application-interface

Migrating your project to Appwrite in one click

To get started, log into your Appwrite cloud, click the Create project button, input supabase-migration as the name, and then click Create.

appwrite-project-tab

Next, navigate to the Settings and click on the Migrations tab.

appwrite-migration-tab

Next, click the Import data button and select Supabase as your source.

appwrite-migration-source

Then, you must fill in the details of your Supabase Postgres credentials in the appropriate fields and click Next.

appwrite-migration-config

Note: You can get the Host, Port, Username, and Password credentials from your Supabase Settings > Database, while you can get the Endpoint and API Key credentials at the Supabase Settings > API

Next, select the Resources you want to migrate; you can choose one or all available options. In this case, select the Databases and click on Create to start your migration.

appwrite-migration-resources

While waiting for your data to import, navigate to your project Overview and Add platform. Choose Web App and complete the necessary fields. This is necessary because Appwrite will reject requests from any unknown web to protect them from malicious attacks.

appwrite-project-overview

After completing the above configurations, navigate back to your Migration tab, and you should see this in your imported data.

appwrite-migration-tab

The above indicates that your supabase project has successfully transferred to your Appwrite.

To confirm this, click on Databases and check your database collections. You should see something like this:

updated-appwrite-database

You have successfully imported your Supabase project into your Appwrite without hassle.

Conclusion

This post discussed how to quickly transfer your data from other sources like Supabase to Appwrite Cloud. This process also demonstrates how Appwrite as a backend-as-a-service makes development less hassle for developers and businesses with the easy use of Appwrite Migration.

Resource

Top comments (0)