Logo RayDB
Tutorial

Deploy PostgreSQL in 60 Seconds – RayDB Quick Start Guide

Go from zero to a running PostgreSQL database in under a minute. This step-by-step tutorial covers cluster creation, connection setup, and your first SQL queries.

Introduction

RayDB makes it easy to deploy and manage PostgreSQL databases on ARM64 infrastructure. In this guide, we’ll walk you through creating your first database cluster and connecting to it.

Prerequisites

  • A RayDB account (sign up at app.raydb.io)
  • A PostgreSQL client like psql or a GUI tool like pgAdmin

Step 1: Create a Team

After signing up, you’ll be prompted to create a team. Teams are the organizational unit in RayDB that contain your database clusters. You can invite team members later to collaborate on your databases.

Step 2: Create Your First Cluster

Navigate to your team dashboard and click “Create Cluster”. You’ll need to:

  1. Choose a cluster name (e.g., “my-first-db”)
  2. Select a data center location
  3. Choose a plan (start with Free for testing)
  4. Click “Create”

Your cluster will be provisioned in about 30 seconds.

Step 3: Connect to Your Database

Once your cluster is ready, you’ll see connection details on the Overview page. Use these to connect with your preferred PostgreSQL client:

psql "postgresql://user:password@your-cluster.raydb.io:5432/postgres"

Step 4: Create Your Schema

Now you’re connected! Create your first table:

CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  email VARCHAR(255) UNIQUE NOT NULL,
  created_at TIMESTAMP DEFAULT NOW()
);

Next Steps

  • Enable automatic backups in the Backups tab
  • Set up monitoring alerts in the Metrics tab
  • Explore our documentation for advanced features
  • Learn why we chose ARM64 for better performance
  • View pricing plans to scale your database

Need Help?

If you run into any issues, our support team is here to help. Contact support or check out our documentation.