Upload folder using huggingface_hub

Dockerfile

@@ -0,0 +1,39 @@
+FROM postgres:15
+
+# Install utilities
+RUN apt-get update && apt-get install -y \
+    wget \
+    unzip \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install pgweb
+RUN wget https://github.com/sosedoff/pgweb/releases/download/v0.14.1/pgweb_linux_amd64.zip \
+    && unzip pgweb_linux_amd64.zip \
+    && mv pgweb_linux_amd64 /usr/local/bin/pgweb \
+    && rm pgweb_linux_amd64.zip
+
+# Create a directory for the custom start script
+WORKDIR /app
+
+# Copy the start script
+COPY start.sh /app/start.sh
+RUN chmod +x /app/start.sh
+
+# Set the user to postgres (UID 999) which is the default for this image
+# However, HF Spaces runs as UID 1000.
+# We need to ensure permissions are correct for /var/lib/postgresql/data
+# The official image creates a volume at /var/lib/postgresql/data
+# We will let the start script handle the user switching or just run as the default user if possible.
+# HF Spaces overrides the user to 1000.
+# We need to make sure the data directory is writable by UID 1000.
+
+# Create the data directory and give permissions to UID 1000
+RUN mkdir -p /var/lib/postgresql/data && \
+    chown -R 1000:1000 /var/lib/postgresql/data && \
+    chmod 700 /var/lib/postgresql/data
+
+# Expose the port for pgweb (HF Spaces expects 7860)
+EXPOSE 7860
+
+# Set the entrypoint to our custom script
+CMD ["/app/start.sh"]

README.md

@@ -1,10 +1,39 @@
 ---
-title: Postgres Db
-emoji: 📚
-colorFrom: gray
-colorTo: yellow
+title: Postgres Database
+emoji: 🐘
+colorFrom: blue
+colorTo: indigo
 sdk: docker
+app_port: 7860
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# PostgreSQL on Hugging Face Spaces
+
+This Space runs a PostgreSQL database instance along with [pgweb](https://github.com/sosedoff/pgweb), a lightweight web-based database browser.
+
+## ⚠️ Important: Persistence
+
+To ensure your data is saved between restarts, you **MUST** enable Persistent Storage in the Space Settings.
+
+1.  Go to **Settings**.
+2.  Scroll to **Persistent Storage**.
+3.  Select a tier (e.g., Small).
+4.  The storage will be mounted at `/data` (which is mapped to `/var/lib/postgresql/data` in the Dockerfile).
+
+## Accessing the Database
+
+The database is accessible via the web interface provided by `pgweb` at the main URL of this Space.
+
+**Default Credentials:**
+- **Host**: `127.0.0.1`
+- **Port**: `5432`
+- **User**: `app_user`
+- **Password**: `app_password`
+- **Database**: `app_db`
+
+## Connecting from other Spaces
+
+You cannot connect to this database from the outside world (e.g., your laptop), but you *might* be able to connect from other Spaces if they are in the same organization/user scope, though typically Spaces are isolated. 
+
+For a production setup, consider using an external database provider (Supabase, Neon, AWS RDS, etc.). This Space is intended for testing, prototyping, or self-contained applications.

start.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+
+# Define data directory
+PGDATA="/var/lib/postgresql/data/pgdata"
+export PGDATA
+
+# Create the data directory if it doesn't exist
+if [ ! -d "$PGDATA" ]; then
+    echo "Initializing database..."
+    mkdir -p "$PGDATA"
+    initdb -D "$PGDATA"
+    
+    # Configure Postgres to listen on localhost only (since we only access via pgweb)
+    # or listen on all interfaces but block external access via firewall/network (which HF does automatically)
+    echo "listen_addresses = '127.0.0.1'" >> "$PGDATA/postgresql.conf"
+    
+    # Create a default user and database
+    # We start postgres in the background to run setup commands
+    pg_ctl -D "$PGDATA" -w start
+    
+    echo "Creating default user and database..."
+    psql -d postgres -c "CREATE USER app_user WITH PASSWORD 'app_password';"
+    psql -d postgres -c "CREATE DATABASE app_db OWNER app_user;"
+    psql -d postgres -c "GRANT ALL PRIVILEGES ON DATABASE app_db TO app_user;"
+    
+    pg_ctl -D "$PGDATA" stop
+fi
+
+# Start Postgres in the background
+echo "Starting PostgreSQL..."
+pg_ctl -D "$PGDATA" -w start &
+
+# Wait for Postgres to be ready
+until pg_isready; do
+  echo "Waiting for PostgreSQL to be ready..."
+  sleep 2
+done
+
+# Start pgweb
+echo "Starting pgweb on port 7860..."
+# We connect to the local postgres instance
+# --bind=0.0.0.0 is required for HF Spaces to expose the port
+pgweb --bind=0.0.0.0 --listen=7860 --url="postgres://app_user:app_password@127.0.0.1:5432/app_db?sslmode=disable"