diff --git a/README.md b/README.md index f4da9bc..c230ee4 100644 --- a/README.md +++ b/README.md @@ -155,7 +155,53 @@ docker-compose logs -f forge-backend --- -## � Troubleshooting Common Issues +## 💾 Database Storage & Access + +### PostgreSQL Database Storage +The database files are stored in a Docker volume for persistence across container restarts. + +**Docker Volume:** `forge-ai_postgres_data` +**Physical Location:** `/var/lib/docker/volumes/forge-ai_postgres_data/_data` + +*Note: On macOS, this is inside Docker Desktop's Linux VM and managed automatically.* + +### Database Connection Info +- **Host:** `localhost` (from your Mac) +- **Port:** `5452` (mapped from container's 5432) +- **Database:** `forge_ai` +- **User:** `forge_user` +- **Password:** `forge_secure_password_2024` + +### Accessing the Database + +**1. Via Docker exec (Interactive SQL):** +```bash +docker exec -it forge-postgres psql -U forge_user -d forge_ai +``` + +**2. Backup the Database:** +```bash +docker exec forge-postgres pg_dump -U forge_user forge_ai > backup.sql +``` + +**3. Restore from Backup:** +```bash +cat backup.sql | docker exec -i forge-postgres psql -U forge_user -d forge_ai +``` + +**4. View Volume Information:** +```bash +docker volume inspect forge-ai_postgres_data +``` + +### Other Storage Locations +- **Uploaded Files/Assets:** `./storage` (in your project directory) +- **Redis Data:** `forge-ai_redis_data` Docker volume +- **Celery Task Queue:** Managed by Redis (in-memory) + +--- + +## ⚠️ Troubleshooting Common Issues ### "Gen-4 Turbo - Validation Failed: Ratio" * **Cause**: Runway's Gen-4 Turbo API is extremely strict about input image resolution (must be 1280x768).