Installation

Install nile-auth in your application

1. Install packages

   npm

     npm install @niledatabase/server @niledatabase/client
   
2. Obtain Database Credentials

   1. If you haven’t signed up for Nile yet, sign up here and follow the steps to create a database.
   2. Navigate to Database Settings in your database’s UI at console.thenile.dev.
   3. Go to Connection settings.
   4. Select the CLI icon, and click Generate credentials
   5. Copy the required credentials and store them in an .env file so they can be used in the application to connect to the Nile auth service.
      .env

      NILEDB_USER=niledb_user
      NILEDB_PASSWORD=niledb_password
      NILEDB_API_URL=https://us-west-2.api.thenile.dev/v2/databases/<database_id>
      NILEDB_POSTGRES_URL=postgres://us-west-2.db.thenile.dev:5432/<database_name>
      
3. Import and configure the nile-auth instance

   nextjs

   import { Nile } from '@niledatabase/server';
   import { nextJs } from '@niledatabase/nextjs';
   export const nile = Nile({ extensions: [nextJs] });
   
4. To handle requests, set up a route handler on your server.

   next-js

   // app/api/[...nile]/route.ts
   import { nile } from "@/nile"; // path to nile instance
   export const { POST, GET, DELETE, PUT } = nile.handlers;
   
5. Call APIs with the nile-auth client

   nile-client.ts

   import { getSession, signUp } from '@niledatabase/client'
   

With that, you’ve successfully set up nile-auth in your application.

Continue on to Social providers, or check out how to integrate into specific frameworks