{% include 'partials/header.html' %}

Database Status

Check your database connection and configuration

Connection Status

{% if status.available %}
Connected {% else %}
Disconnected {% endif %}

{{ status.database_type }}

{{ status.database_url }}

{% if status.available %}Available{% else %}Unavailable{% endif %}

{% if status.error %}

{{ status.error }}

{% endif %}

Troubleshooting Guide

{% if not status.available %}

Database Connection Failed: Your application cannot connect to the database. This is common in serverless environments.

{% endif %}

Common Solutions

  • • Check Environment Variables: Ensure DATABASE_URL is properly set in your environment
  • • Serverless Environments: SQLite may not work in serverless environments like Leapcell. Consider using PostgreSQL or another cloud database
  • • Database Permissions: Ensure your database user has the necessary permissions
  • • Network Access: Check if your database is accessible from your deployment environment

For Serverless Deployments

Recommended Database Options:

  • • PostgreSQL (Supabase, Neon, PlanetScale)

Note: Only PostgreSQL has been tested with Leapcell. Use postgresql+psycopg in your DATABASE_URL (asyncpg and psycopg2 are not supported).

Quick Fixes

Environment Variables

Set DATABASE_URL in your environment:

DATABASE_URL=postgresql+psycopg://user:pass@host:port/db
Database Initialization

Initialize database:

uv run python oppman.py db
Back to Home API Status
{% include 'partials/footer.html' %}