Preview Environment Quick Reference #

# 1. Create PR targeting 'main' branch
git push origin your-feature-branch

# 2. Add 'preview' label to PR on GitHub
# 3. Wait ~40 minutes for environment to be ready
# 4. Access via URL in PR comments

# Navigate to project
cd ~/bonsai

# Check service status
docker compose -f docker-compose.preview.yml ps

# View logs (all services)
docker compose -f docker-compose.preview.yml logs -f

# View logs (specific service)
docker compose -f docker-compose.preview.yml logs -f bonsapi

# Restart all services
docker compose -f docker-compose.preview.yml restart

# Restart specific service
docker compose -f docker-compose.preview.yml restart webapp

# Check resource usage
docker stats

# Check disk space
df -h

# Access database shell
docker exec -it database psql -U postgres -d bonsai

# Common queries
\dt                          # List tables
\d table_name               # Describe table
SELECT * FROM users LIMIT 5; # Query data

# Backup database
docker exec database pg_dump -U postgres bonsai > backup.sql

# Restore database
cat backup.sql | docker exec -i database psql -U postgres bonsai

# Check queues
docker exec bonsai-rabbitmq rabbitmqctl list_queues

# Purge specific queue
docker exec bonsai-rabbitmq rabbitmqctl purge_queue <queue-name>

# Or use web UI
# Access via Coder workspace apps

# Access Redis CLI
docker exec -it bonsai-redis redis-cli

# Common commands
KEYS *           # List all keys
GET key_name     # Get value
FLUSHALL         # Clear all data (careful!)

# 1. Check workspace status
Visit: https://coder.internal.gotofu.com/workspaces

# 2. If stopped, start it
Click "Start" → Wait 2-3 minutes

# 3. If unhealthy, check logs
Workspace page → Builds → View logs

# 1. Check which service is down
docker compose -f docker-compose.preview.yml ps

# 2. Restart the service
docker compose -f docker-compose.preview.yml restart <service-name>

# 3. Check logs for errors
docker compose -f docker-compose.preview.yml logs <service-name> --tail=100

# 1. Check backend service
docker compose -f docker-compose.preview.yml ps bonsapi

# 2. Restart if needed
docker compose -f docker-compose.preview.yml restart bonsapi

# 3. Restart nginx proxy
docker compose -f docker-compose.preview.yml restart nginx-proxy

# 1. Verify PR has 'preview' label
# 2. Check GitHub Actions for rebuild
# 3. Manually restart if needed
Coder Dashboard → Workspace → Restart

# Clean Docker resources
docker system prune -a
docker volume prune

# Clean Rust build cache
cd ~/bonsai && cargo clean

# Clean Node modules (requires reinstall)
rm -rf node_modules apps/webapp/node_modules

# 1. Get preview URL from PR
# 2. Contact developer with OAuth admin access
# 3. Provide: Preview URL + PR number
# 4. Developer adds redirect URI in Xero Developer Portal
# 5. Connect via Settings → Integrations → Xero → Connect

# 1. Get preview URL from PR
# 2. Contact developer with QBO admin access
# 3. Provide: Preview URL + PR number
# 4. Developer adds redirect URI in QuickBooks Developer Portal
# 5. Connect via Settings → Integrations → QuickBooks → Connect

# 1. Get preview URL from PR
# 2. Contact developer with Azure AD admin access
# 3. Provide: Preview URL + SharePoint site + PR number
# 4. Developer adds redirect URI in Azure Portal
# 5. Wait ~5 minutes for propagation
# 6. Connect via Settings → Integrations → SharePoint → Connect

# View all environment variables
env | grep -E "(DATABASE|REDIS|RABBITMQ|AWS|CLERK)"

# Common variables
echo $DATABASE_URL
echo $REDIS_URL
echo $RABBITMQ_URL
echo $NEXT_PUBLIC_BONSAPI_HOST