Docs/Connect/Connection Strings

Connection Strings

Everything you need to know about PhoenixDB connection strings.

Connection String Format

PhoenixDB uses standard PostgreSQL connection string format:

postgresql://[user]:[password]@[host]:[port]/[database]?[params]

Connection String Components

User

postgres

The database user. Always postgres for PhoenixDB databases.

Password

Your database password, generated when you create the database. Store it securely!

Host

*.phoenixdb.space

Your unique subdomain. Each database gets a dedicated subdomain like abc123.server1.phoenixdb.space.

Port

5432

Standard PostgreSQL port. May vary for some databases.

Query Parameters

ParameterValueDescription
sslmoderequireAlways use SSL (recommended)
connect_timeout30Connection timeout in seconds
application_namemy-appIdentify your app in logs

Connection Examples

Standard Connection String

Works with most PostgreSQL clients and libraries

postgresql://postgres:YOUR_PASSWORD@abc123.server1.phoenixdb.space:5432/mydb?sslmode=require

Prisma

For schema.prisma datasource block

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

Drizzle ORM

For drizzle.config.ts

import { drizzle } from 'drizzle-orm/postgres-js';
import postgres from 'postgres';

const client = postgres(process.env.DATABASE_URL!);
export const db = drizzle(client);

Sequelize

For Sequelize configuration

const { Sequelize } = require('sequelize');

const sequelize = new Sequelize(process.env.DATABASE_URL, {
  dialect: 'postgres',
  dialectOptions: {
    ssl: { rejectUnauthorized: false }
  }
});