docs: Update setup and troubleshooting guides

- Add Docker build troubleshooting section
- Update Quick Start with SSL cert and public dir steps
- Add prisma db push instruction for database setup
- Document common build errors and solutions
This commit is contained in:
2026-04-15 14:21:37 -04:00
parent 2388873e7a
commit 9516f5d570
3 changed files with 105 additions and 17 deletions
+13 -8
View File
@@ -69,12 +69,12 @@ anchor deploy
### 5. Database Setup
```bash
# Start PostgreSQL
docker-compose up -d postgres
# Start PostgreSQL and Redis
docker-compose up -d postgres redis
# Run migrations
# Push schema to database (no migrations needed for fresh setup)
cd backend
npx prisma migrate dev
npx prisma db push
# Generate Prisma client
npx prisma generate
@@ -104,13 +104,18 @@ npm run dev:frontend # Next.js on port 3000
### 8. Production Deployment
```bash
# Setup SSL certificates
# Setup SSL certificates (self-signed for local dev, or use real certs)
mkdir -p docker/nginx/ssl
cp your-cert.pem docker/nginx/ssl/cert.pem
cp your-key.pem docker/nginx/ssl/key.pem
openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
-keyout docker/nginx/ssl/key.pem \
-out docker/nginx/ssl/cert.pem \
-subj "/CN=coop.hobokenchicken.com"
# Create public directory (required for build)
mkdir -p frontend/public
# Deploy
npm run deploy
docker-compose up -d --build
```
## Architecture Overview