Add database storage and access documentation to README

This commit is contained in:
DJP 2025-12-10 23:22:20 -05:00
parent 7087dc6a23
commit 0cf616a7f6

View file

@ -155,7 +155,53 @@ docker-compose logs -f forge-backend
---
## <20> 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).