chore: update README

docs/prerequisites.md

@@ -0,0 +1,64 @@
+# Prerequisites
+
+## System Requirements
+
+### Minimum Requirements
+- **RAM**: 8 GB (4 GB available for Docker)
+- **Storage**: 10 GB free disk space
+- **CPU**: 2 cores (x86_64 or ARM64)
+- **OS**: 
+  - macOS 10.15+ (Catalina or newer)\
+  - Windows 10/11 with WSL2
+  - Linux with kernel 3.10+
+
+## Software Requirements
+
+To run Dograh AI locally, make sure you have the following installed:
+
+- [Docker](https://docs.docker.com/get-docker/) (version 20.10 or later)
+- [curl](https://curl.se/download.html)  usually preinstalled on macOS/Linux
+
+> **Note**  
+> Docker Compose is included with Docker Desktop. Make sure Docker is running before you begin.
+
+### Docker Resource Allocation
+For Docker Desktop users, ensure Docker has adequate resources:
+1. Open Docker Desktop settings
+2. Navigate to Resources
+3. Allocate at least:
+   - Memory: 4 GB (8 GB recommended)
+   - CPUs: 2 (4 recommended)
+   - Disk: 10 GB
+
+## Required Ports
+
+Ensure these ports are available:
+- `3010` - Web UI
+- `8000` - API Server
+- `5432` - PostgreSQL
+- `6379` - Redis
+- `9000` - MinIO (S3-compatible storage)
+- `9001` - MinIO Console
+
+## Checking Port Availability
+
+##### Check if a port is in use (replace 3010 with the port number)
+```bash
+lsof -i :3010
+```
+
+## Docker Registry Options
+
+Dograh images are available from two registries that you can choose from:
+
+- **GitHub Container Registry (Default)**: `ghcr.io/dograh-hq` - Recommended for most users
+- **Docker Hub**: `dograhai` - Alternative registry
+
+To use a specific registry, set the `REGISTRY` environment variable using either of the following:
+
+##### Using GitHub Container Registry (recommended) or Docker Hub
+```bash
+REGISTRY=ghcr.io/dograh-hq docker compose up
+
+REGISTRY=dograhai docker compose up
+```

docs/troubleshooting.md

@@ -0,0 +1,45 @@
+# Troubleshooting
+
+## Freeing Up Ports
+
+### When a port is already in use:
+##### Check what's using the port first and then kill the process (may require sudo on Linux)
+```bash
+lsof -i :3010
+
+kill -9 $(lsof -t -i :3010)
+```
+
+### When Docker containers are using the ports (with auto-restart enabled):
+
+**Step 1:** Stop all running containers
+```bash
+docker stop $(docker ps -q)
+```
+
+**Step 2:** Disable restart policy for all containers
+This prevents containers from automatically restarting:
+```bash
+docker update --restart=no $(docker ps -a -q)
+```
+
+**Step 3:** Verify
+
+Check that no containers are running:
+```bash
+docker ps
+```
+
+Check restart policies (should show 'no' for each container):
+```bash
+docker inspect -f '{{.Name}} - {{.HostConfig.RestartPolicy.Name}}' $(docker ps -a -q)
+```
+
+
+## Stopping Dograh Services
+##### Stop services or Stop and remove all data (full cleanup)
+```bash
+docker compose down
+
+docker compose down -v
+```