Deployment & Operations Guide
This guide covers deploying and operating the Claw Machine Manager inventory system in various environments, from local testing to production deployment.
Prerequisites
Required: Docker Engine 20.10+ and Docker Compose v2+ 2GB+ available RAM 5GB+ available disk spa...
First-Time Deployment
Use these steps when deploying from scratch (fresh installation with no existing data). Step 1: N...
Moving to Production Server
Follow these steps when deploying to a production server for the first time. Step 1: Transfer Pro...
Day-to-Day Operations
Starting Services (Normal Operation) docker compose up -d Data persists - All inventory, items, ...
Wiping Data & Restarting
Use this when you need to completely reset the database (testing, starting fresh, etc.). ⚠️ WARNI...
Stopping Services
Stop But Keep Data Recommended for normal shutdown: docker compose down This stops and removes c...
When to Rebuild
The --build flag is only needed for the backend service (the only one with a custom Dockerfile). ...
Configuration for Production
Security Considerations 1. Change default database credentials Edit docker-compose.yaml: environm...
Troubleshooting
Services Won't Start Check logs: docker compose logs backend docker compose logs db Common issue...
Quick Reference
First-time setup: docker compose up -d docker compose ps # Wait for "healthy" docker exec -i inv...
Support
For issues or questions: Check docs/status.md for current project status Review docs/bugs.md for...