> ## Documentation Index
> Fetch the complete documentation index at: https://docs.steadwing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Supabase

> Steadwing connects to your Supabase projects to monitor database health, connection pools, authentication errors, and service status for AI-powered incident analysis.

## What does the Supabase integration do?

Steadwing accesses your Supabase projects, database metrics, and configuration data to diagnose database-related incidents. During root cause analysis, Steadwing investigates database performance issues, connection pool problems, authentication errors, and service health to identify the underlying causes of incidents.

## Why Use Supabase with Steadwing?

<CardGroup cols={2}>
  <Card title="Database Health Monitoring" icon="database">
    Monitor PostgreSQL performance, connection pools, and query metrics
  </Card>

  <Card title="Service Status Tracking" icon="heart-pulse">
    Track the health status of all Supabase services (Auth, Storage, PostgREST)
  </Card>

  <Card title="Configuration Analysis" icon="settings">
    Analyze database and API configurations to identify misconfigurations
  </Card>

  <Card title="Schema Investigation" icon="table">
    Inspect table schemas, functions, and database branches during incidents
  </Card>
</CardGroup>

## How do I connect Supabase to Steadwing?

### Step 1: Connect Supabase OAuth

1. Navigate to [Steadwing Settings](https://app.steadwing.com/settings)
2. Find the **Supabase** integration card
3. Click the **Connect** button (toggle switch)
4. You will be redirected to Supabase's authorization page
5. Select the organization you want to connect
6. Click **Authorize** to grant Steadwing access to your Supabase projects

## What data does Steadwing pull from Supabase?

### Data Collection

Steadwing can query Supabase for:

* **Service Health** - Real-time health status of all Supabase services
* **Database Metrics** - PostgreSQL configuration, connection pool stats, and performance data
* **Project Information** - All projects, branches, and their configurations
* **Schema Details** - Table schemas, database functions, and stored procedures
* **Storage Data** - Storage buckets and their configurations
* **Auth Configuration** - Authentication settings and providers
* **Network Settings** - Network restrictions, bans, and security configurations

## Available Capabilities

### Database Management

* List all database tables and their schemas
* Retrieve database function definitions
* Inspect database branches and configurations
* View backup history

### Project Configuration

* Get PostgreSQL configuration settings
* Review PostgREST API configuration
* Check PgBouncer connection pooling settings
* Analyze authentication configuration

### Service Monitoring

* Monitor service health status across all components
* Track project upgrade status
* Review network restrictions and security settings
* Inspect pgsodium encryption configuration

## What permissions does the Supabase integration need?

### Required Permissions

The Supabase OAuth integration requires:

* **Read access** to your Supabase organization
* **Read access** to project configurations
* **Read access** to database metadata
* **Write access** to database schema operations (index creation, configuration changes)

Steadwing does **NOT** have permission to:

* Modify user data rows
* Delete or create projects
* Access sensitive user data

<Note>
  Steadwing can execute schema DDL operations (such as creating indexes or altering table configurations) as part of automated remediation, only after user's approval. Steadwing does NOT modify user data rows.
</Note>

### Supported Features

* Service health monitoring
* Database configuration analysis
* Schema and function inspection
* Connection pool monitoring
* Authentication configuration review
* Storage bucket management
* Network security analysis

## FAQs

<AccordionGroup>
  <Accordion title="What Supabase data does Steadwing access?">
    Steadwing reads project configurations, database schemas, service health status, and metadata. It does NOT access your actual database data, user information, or modify any settings.
  </Accordion>

  <Accordion title="Can I limit Steadwing's access to specific Supabase projects?">
    The OAuth flow grants access at the organization level. You can control which projects Steadwing analyzes by managing your Supabase organization permissions.
  </Accordion>

  <Accordion title="Does Steadwing modify my Supabase configuration?">
    Steadwing can execute approved schema changes like creating indexes or altering table configurations as part of automated remediation. All actions require explicit user approval before execution. Steadwing does not modify user data rows.
  </Accordion>

  <Accordion title="How does Steadwing use Supabase data during RCA?">
    When an incident occurs, Steadwing queries relevant Supabase metrics and configurations to identify database-related issues like connection pool exhaustion, slow queries, or service degradation.
  </Accordion>

  <Accordion title="Can I disconnect the Supabase integration?">
    Yes, go to [Settings](https://app.steadwing.com/settings), find the Supabase integration, and click the toggle to disconnect. This will revoke Steadwing's access to your Supabase organization.
  </Accordion>

  <Accordion title="What happens if my Supabase OAuth token expires?">
    OAuth tokens are automatically refreshed by Supabase. If the connection is lost, you'll need to reconnect by following the setup instructions again.
  </Accordion>
</AccordionGroup>

Need additional help? Please reach out to us at [hello@steadwing.com](mailto:hello@steadwing.com)