Add database storage and access documentation to README
This commit is contained in:
parent
7087dc6a23
commit
0cf616a7f6
1 changed files with 47 additions and 1 deletions
48
README.md
48
README.md
|
|
@ -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).
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue