Supabase Platform, Self-Hosting & Migration

# Tạo branch từ production để test migration mới
supabase branches create feature-x --source main

# Mỗi branch có database riêng biệt -- test schema changes không ảnh hưởng production
supabase branches list
supabase branches delete feature-x

# Tạo log drain
supabase log-drain create --project-ref [REF] \
  --destination datadog \
  --config api_key=xxx,site=datadoghq.com

# Liệt kê log drains
supabase log-drain list --project-ref [REF]

# Xóa log drain
supabase log-drain delete --project-ref [REF] [DRAIN_ID]

# Clone Supabase repository
git clone --depth 1 https://github.com/supabase/supabase

# Vào thư mục docker
cd supabase/docker

# Copy và cấu hình biến môi trường
cp .env.example .env

# Khởi động toàn bộ stack
docker compose -f docker-compose.yml up -d

# ==================== DATABASE ====================
POSTGRES_PASSWORD=your-super-secret-password
# Mật khẩu của postgres user — PHẢI thay đổi trong production

# ==================== AUTH / JWT ====================
JWT_SECRET=your-super-secret-jwt-token
# Secret key dùng để ký JWT token — PHẢI là string ngẫu nhiên, ít nhất 32 chars
# Shared giữa Kong, GoTrue, PostgREST để verify JWT

ANON_KEY=generated-anon-key
# API key cho anonymous users — có quyền thấp nhất (dùng cho client-side)
# Được generate từ JWT_SECRET với role=anon

SERVICE_ROLE_KEY=generated-service-role-key
# API key cho admin — bypass RLS, full quyền (dùng cho backend/Edge Functions)
# Được generate từ JWT_SECRET với role=service_role

# ==================== URL / NETWORK ====================
SITE_URL=http://localhost:3000
# URL của app frontend — dùng cho redirect URLs (OAuth callback, email confirmation)

API_EXTERNAL_URL=http://localhost:8000
# URL của Kong API Gateway — endpoint chính cho tất cả API requests

STUDIO_DEFAULT_ORGANIZATION=My Org
# Tên organization mặc định hiển thị trong Studio

STUDIO_DEFAULT_PROJECT=My Project
# Tên project mặc định hiển thị trong Studio

# ==================== EMAIL (SMTP) ====================
SMTP_HOST=smtp.sendgrid.net
SMTP_PORT=587
SMTP_USER=apikey
SMTP_PASS=your-sendgrid-key
SMTP_SENDER_NAME=My App
SMTP_SENDER_ADDRESS=noreply@myapp.com
# Cấu hình SMTP để gửi email xác thực, magic link, reset password
# Hỗ trợ: SendGrid, Resend, AWS SES, Mailgun, custom SMTP

# ==================== STORAGE ====================
STORAGE_BACKEND=s3
# Backend lưu trữ file: 'file' (local disk) hoặc 's3' (S3-compatible)
# Dùng 's3' trong production với MinIO hoặc AWS S3

S3_ENDPOINT=https://s3.amazonaws.com
S3_REGION=us-east-1
S3_BUCKET=my-supabase-storage
S3_ACCESS_KEY=xxx
S3_SECRET_KEY=xxx
# Chỉ cần khi STORAGE_BACKEND=s3

helm repo add supabase https://supabase-community.github.io/helm-charts
helm install supabase supabase/supabase

# Trong .env của Docker Compose
STORAGE_BACKEND=s3
S3_ENDPOINT=https://s3.amazonaws.com
S3_REGION=us-east-1
S3_BUCKET=my-supabase-storage
S3_ACCESS_KEY=xxx
S3_SECRET_KEY=xxx

# Clone migration tool
git clone https://github.com/supabase-community/firebase-to-supabase.git

# Export Firebase users ra JSON
node firestoreusers2json.js users.json 100

# Import users vào Supabase Auth
node import_users.js users.json 100

# Tạo supabase-service.json với connection info
{
  "url": "https://[PROJECT_REF].supabase.co",
  "service_role_key": "eyJhbGciOi..."
}

# Tạo firebase-service.json từ Firebase Console
# Project Settings > Service Accounts > Generate New Private Key
{
  "type": "service_account",
  "project_id": "my-firebase-project",
  "private_key": "-----BEGIN PRIVATE KEY-----...",
  "client_email": "firebase-adminsdk@..."
}

node firestoreusers2json.js users.json 100

node import_users.js users.json 100

# Liệt kê tất cả collections
node collections.js

# Export collection ra JSON
node firestore2json.js users 1000

# Import vào Supabase Postgres
node json2supabase.js ./users.json bigserial id

// Firestore document (NoSQL — nested)
{
  "id": "user-123",
  "name": "Vinh",
  "email": "vinh@example.com",
  "address": {                        // Nested object -> Cần flatten
    "street": "123 Main St",
    "city": "Hanoi",
    "country": "Vietnam"
  },
  "posts": [                          // Sub-collection -> Cần tách bảng riêng
    { "title": "Post 1", "content": "..." },
    { "title": "Post 2", "content": "..." }
  ],
  "tags": ["react", "supabase"]       // Array -> Cần bảng junction
}

// Postgres schema (SQL — relational)
CREATE TABLE users (
  id UUID PRIMARY KEY,
  name TEXT,
  email TEXT UNIQUE,
  address_street TEXT,                // Flattened
  address_city TEXT,                  // Flattened
  address_country TEXT                // Flattened
);

CREATE TABLE posts (
  id BIGSERIAL PRIMARY KEY,
  user_id UUID REFERENCES users(id),
  title TEXT,
  content TEXT
);

CREATE TABLE user_tags (
  user_id UUID REFERENCES users(id),
  tag TEXT,
  PRIMARY KEY (user_id, tag)
);

const admin = require('firebase-admin')
admin.initializeApp({ credential: admin.credential.cert(serviceAccount) })

const bucket = admin.storage().bucket()
const [files] = await bucket.getFiles()

for (const file of files) {
  console.log(file.name, file.metadata.size)
  // Download và upload lên Supabase Storage
}

const tempPath = `/tmp/${file.name}`
await file.download({ destination: tempPath })

const fileBuffer = fs.readFileSync(tempPath)
const { data, error } = await supabase.storage
  .from('migrated-files')
  .upload(file.name, fileBuffer, {
    contentType: file.metadata.contentType || 'application/octet-stream',
    cacheControl: file.metadata.cacheControl || '3600'
  })

// Firebase Security Rules (Firestore)
rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // Users can read their own data
    match /users/{userId} {
      allow read: if request.auth.uid == userId;
      allow write: if request.auth.uid == userId;
    }
    // Anyone can read published posts
    match /posts/{postId} {
      allow read: if resource.data.published == true;
      allow write: if request.auth.uid == resource.data.author_id;
    }
  }
}

-- Policy: Users can read their own data
CREATE POLICY "Users can access own data"
ON users FOR ALL
USING (auth.uid() = id)
WITH CHECK (auth.uid() = id);

-- Policy: Anyone can read published posts
CREATE POLICY "Anyone can read published posts"
ON posts FOR SELECT
USING (published = true);

-- Policy: Authors can edit their posts
CREATE POLICY "Authors can edit own posts"
ON posts FOR INSERT
WITH CHECK (auth.uid() = author_id);

CREATE POLICY "Authors can update own posts"
ON posts FOR UPDATE
USING (auth.uid() = author_id)
WITH CHECK (auth.uid() = author_id);

# Export từ RDS
pg_dump -h [RDS_HOST] -U [USER] -d [DB_NAME] \
  --no-owner --no-acl -f dump.sql

# Import vào Supabase
psql -h [SUPABASE_HOST] -U postgres -d postgres -f dump.sql

# Từ Heroku
heroku pg:backups:capture --app your-app
heroku pg:backups:download --app your-app

# Import vào Supabase
pg_restore -h [SUPABASE_HOST] -U postgres -d postgres latest.dump

# Pull schema từ Vercel/Neon
pg_dump -h [HOST] -U [USER] -d [DB] --schema-only -f schema.sql

# Push vào Supabase qua migration
supabase db push

-- Bật extension
CREATE EXTENSION IF NOT EXISTS pg_cron;

-- Job chạy SQL mỗi phút -- dọn dữ liệu tạm cũ
SELECT cron.schedule(
  'cleanup-temp',
  '* * * * *',
  'DELETE FROM temp_data WHERE created_at < now() - interval ''1 hour'''
);

-- Job gọi Edge Function mỗi giờ
SELECT cron.schedule(
  'hourly-sync',
  '0 * * * *',
  $$
  SELECT net.http_post(
    url := 'https://[REF].supabase.co/functions/v1/sync-data',
    headers := '{"Authorization": "Bearer [SERVICE_ROLE_KEY]"}'::jsonb
  )
  $$
);

-- Quản lý jobs
SELECT * FROM cron.job;                              -- Danh sách jobs
SELECT * FROM cron.job_run_details;                  -- Lịch sử chạy
SELECT cron.unschedule('cleanup-temp');               -- Hủy job

-- Bật extension + tạo queue
CREATE EXTENSION IF NOT EXISTS pgmq;
SELECT pgmq.create('task_queue');

-- Gửi message
SELECT pgmq.send('task_queue', '{"task": "send_email", "to": "user@example.com", "template": "welcome"}');

-- Consumer: đọc message (visibility timeout 60 giây)
SELECT * FROM pgmq.read('task_queue', 10, 60);

-- Xác nhận đã xử lý
SELECT pgmq.delete('task_queue', msg_id);

-- Archive message đã xử lý (giữ lại để audit)
SELECT pgmq.archive('task_queue', msg_id);

-- Pop (đọc + xóa atomic)
SELECT * FROM pgmq.pop('task_queue');

npm install @supabase/auth-ui-react @supabase/auth-ui-shared

npx skills add supabase/agent-skills