Installation

Set up Rowy on your Google Cloud or Firebase project in minutes.

Option 1: Quick setup — ✅ Recommended

You can set up Rowy using our guided setup process. It will take less than 2 minutes to complete.

Deploy now

You can use Rowy with existing Firebase project or by creating a new one by simply following the guided setup process with the deploy button above.

Option 2: Manual install

If you don’t want to set up Rowy as described above, you can follow these steps to install it manually for development before hosting it yourself.

Required

This setup is for developers familiar with Firebase and GCP console. If you want a nocode like setup experience use Option 1.

Before starting, make sure you have a Google Cloud or Firebase project with Firestore and Firebase Authentication enabled.

Don’t have a project? Learn how to create one →

Required software

• Git
• Node 16+ (it’s easiest to install using nvm)
• Yarn 1
• Firebase CLI 8+

1. Make sure you’re logged in to your Firebase account in the Firebase CLI:

   firebase login

2. Clone the Rowy repo and open the created directory.

   git clone https://github.com/rowyio/rowy.git
   cd rowy

3. Set environment variables.

   • Create a .env file.
   • Get the Project ID and Web API key in the Firebase Console ↗
     Can’t see it? Enable Firebase Authentication ↗ first.
   • Paste them in the .env file:

     REACT_APP_FIREBASE_PROJECT_ID =
     REACT_APP_FIREBASE_PROJECT_WEB_API_KEY =

4. Install frontend dependencies using Yarn.

   yarn

5. Run the app locally.

   yarn start

6. Sign in with your Google account. You’ll see an Access denied screen.

7. Set the ADMIN role for your account using these instructions →

8. Sign out and sign in again to access your Rowy project.

Some backend features require Rowy Run to be installed on your project. You’ll need to install Rowy Run manually:

Install Rowy Run

Common Issues

1. ERROR MESSAGE: rowy@3.0.0: The engine "node" is incompatible with this module. Expected version ">=16". Got "14.19.0.

   FIX:

   • Update your node version to 16 or higher by downloading the latest LTS version from https://nodejs.org/en/download/.

2. ERROR MESSAGE: auth/invalid-api-key: Firebase: Error (auth/invalid-api-key).

   FIX:

   • Login to the firebase account using the Firebase CLI. Install Firebase CLI globally using npm install -g firebase-tools.
   • Setting up environment variables as described in the 3rd step of the manual installation process.