diff --git a/DEPLOYMENT_SUCCESS.md b/DEPLOYMENT_SUCCESS.md
new file mode 100644
index 0000000000..dc7a210f22
--- /dev/null
+++ b/DEPLOYMENT_SUCCESS.md
@@ -0,0 +1,108 @@
+# Archon Deployment Success - August 14, 2025
+
+## 🎉 Successfully Deployed Archon with Custom Configuration
+
+### Deployment Summary
+Successfully deployed Archon with local Supabase integration, custom ports, and Ollama configuration for local LLM usage.
+
+### Key Achievements
+
+#### 1. ✅ Fixed Docker Connection Issues
+- Resolved DOCKER_HOST environment variable conflict with Podman
+- Created startup script to properly unset DOCKER_HOST
+- Ensured Docker daemon connectivity
+
+#### 2. ✅ Configured Custom Ports (No Conflicts)
+**External → Internal Port Mappings:**
+- Web UI: `4838 → 5173`
+- API Server: `9282 → 8181`  
+- MCP Server: `9151 → 8051`
+- Agents Service: `9152 → 8052`
+
+**Avoided conflicts with:**
+- Existing Supabase (54321-54327)
+- CubExplorer Streamlit apps (8501, 8504)
+
+#### 3. ✅ Solved Network Connectivity
+**Problem:** Archon containers couldn't reach Supabase on localhost
+**Solution:** Connected Archon containers to Supabase's Docker network (`supabase_network_Archon`)
+- Changed from isolated network to shared Supabase network
+- Updated connection URLs to use container names (`supabase_kong_Archon:8000`)
+
+#### 4. ✅ Environment Configuration
+```bash
+# .env configuration
+SUPABASE_URL=http://localhost:54321
+SUPABASE_SERVICE_KEY=eyJhbGc...  # Local Supabase default key
+ARCHON_SERVER_PORT=9282
+ARCHON_MCP_PORT=9151
+ARCHON_AGENTS_PORT=9152
+ARCHON_UI_PORT=4838
+OLLAMA_HOST=http://host.docker.internal:11434
+```
+
+#### 5. ✅ Database Setup
+- Archon tables already initialized in local Supabase
+- All migrations successfully applied
+- Settings table ready for configuration
+
+### Docker Architecture
+```
+Archon Containers → supabase_network_Archon ← Supabase Containers
+                            ↓
+                    Internal Communication
+                    (using container names)
+```
+
+### Quick Commands
+
+#### Start Archon
+```bash
+unset DOCKER_HOST && docker compose up -d
+# OR use the startup script:
+./start_archon.sh
+```
+
+#### Stop Archon
+```bash
+unset DOCKER_HOST && docker compose down
+```
+
+#### View Logs
+```bash
+unset DOCKER_HOST && docker compose logs -f
+```
+
+#### Check Health
+```bash
+curl http://localhost:9282/health  # API Server
+curl http://localhost:9152/health  # Agents Service
+```
+
+### Access Points
+- **Web UI**: http://localhost:4838
+- **API Server**: http://localhost:9282
+- **MCP Server**: http://localhost:9151
+- **Agents Service**: http://localhost:9152
+- **Supabase Studio**: http://localhost:54323
+
+### Next Steps
+1. Open Web UI at http://localhost:4838
+2. Configure Ollama in Settings
+3. Start using Knowledge Base features
+4. Set up MCP integration with AI coding assistants
+
+### Troubleshooting Tips
+- Always use `unset DOCKER_HOST` before Docker commands
+- Containers use internal ports (8181, 8051, 8052)
+- External ports are mapped for browser access
+- All services share `supabase_network_Archon` network
+
+### Port Mapping Reminder
+Docker syntax: `EXTERNAL:INTERNAL`
+- Example: `4838:5173` means:
+  - Access via browser: `localhost:4838`
+  - Container listens on: `5173`
+
+---
+*Deployment completed successfully on August 14, 2025*
\ No newline at end of file
diff --git a/DEPLOYMENT_TROUBLESHOOTING.md b/DEPLOYMENT_TROUBLESHOOTING.md
new file mode 100644
index 0000000000..8e0198d154
--- /dev/null
+++ b/DEPLOYMENT_TROUBLESHOOTING.md
@@ -0,0 +1,239 @@
+# Archon Deployment Troubleshooting Guide
+
+## Common Issues and Solutions
+
+### 1. Container Can't Connect to Supabase (Connection Timeout)
+
+**Symptoms:**
+```
+httpx.ConnectTimeout: timed out
+ERROR: Application startup failed. Exiting.
+```
+
+**Causes & Solutions:**
+
+#### A. Network Isolation (Most Common on Linux)
+**Problem:** Docker containers can't reach host services through `localhost` or `host.docker.internal`
+
+**Solution 1 - Use Docker Bridge Gateway:**
+```yaml
+# docker-compose.yml
+environment:
+  - SUPABASE_URL=http://172.17.0.1:54321  # Docker bridge gateway IP
+```
+
+**Solution 2 - Share Supabase Network:**
+```yaml
+# docker-compose.yml
+networks:
+  app-network:
+    external: true
+    name: supabase_network_name  # Find with: docker network ls
+
+environment:
+  - SUPABASE_URL=http://supabase_kong:8000  # Use container name
+```
+
+#### B. Incorrect Host Resolution
+**Problem:** `host.docker.internal` doesn't work on Linux
+
+**Solution:**
+```yaml
+# docker-compose.yml
+extra_hosts:
+  - "host.docker.internal:host-gateway"  # Let Docker resolve it
+```
+
+### 2. Port Conflicts
+
+**Symptoms:**
+```
+Error response from daemon: driver failed programming external connectivity
+Bind for 0.0.0.0:8181 failed: port is already allocated
+```
+
+**Solution:**
+```bash
+# .env - Use different external ports
+ARCHON_SERVER_PORT=9282  # Instead of 8181
+ARCHON_MCP_PORT=9151     # Instead of 8051
+ARCHON_AGENTS_PORT=9152  # Instead of 8052
+ARCHON_UI_PORT=4838      # Instead of 3737
+```
+
+### 3. DOCKER_HOST Environment Conflicts
+
+**Symptoms:**
+```
+Cannot connect to the Docker daemon at unix:///run/user/1000/podman/podman.sock
+```
+
+**Cause:** System has Podman or custom Docker configuration
+
+**Solution:**
+```bash
+# Always unset DOCKER_HOST before Docker commands
+unset DOCKER_HOST && docker compose up -d
+
+# Or add to ~/.bashrc for permanent fix:
+alias docker-compose='unset DOCKER_HOST && docker compose'
+```
+
+### 4. Container Health Check Failures
+
+**Symptoms:**
+- Container shows as `(unhealthy)` in docker ps
+- Services don't respond on expected ports
+
+**Debugging Steps:**
+```bash
+# Check detailed logs
+docker logs Archon-Server --tail=50
+
+# Test internal connectivity
+docker exec Archon-Server python -c "import urllib.request; print(urllib.request.urlopen('http://localhost:8181/health').read())"
+
+# Check network connectivity
+docker exec Archon-Server ping -c 1 supabase_kong
+```
+
+### 5. Supabase Not Accessible
+
+**Symptoms:**
+- Can't connect to Supabase from Archon
+- API calls timeout
+
+**Debugging:**
+```bash
+# Find Supabase container name and network
+docker ps | grep supabase
+docker inspect [supabase_container] | grep NetworkMode
+
+# Test connectivity from host
+curl http://localhost:54321/rest/v1/
+
+# Test from Archon container
+docker exec Archon-Server curl http://host.docker.internal:54321/rest/v1/
+```
+
+### 6. Frontend Can't Connect to Backend
+
+**Symptoms:**
+- UI loads but API calls fail
+- CORS errors in browser console
+
+**Solution:**
+```yaml
+# docker-compose.yml - Ensure frontend knows external port
+environment:
+  - VITE_API_URL=http://localhost:${ARCHON_SERVER_PORT:-8181}
+```
+
+### 7. Database Migration Issues
+
+**Symptoms:**
+- Tables don't exist errors
+- Missing functions or procedures
+
+**Solution:**
+```sql
+-- Run in Supabase SQL Editor
+-- 1. First check if tables exist
+SELECT tablename FROM pg_tables WHERE schemaname = 'public' AND tablename LIKE 'archon_%';
+
+-- 2. If missing, run migration
+-- Execute contents of migration/complete_setup.sql
+
+-- 3. If partial, reset and retry
+-- Execute contents of migration/RESET_DB.sql
+-- Then migration/complete_setup.sql
+```
+
+## Platform-Specific Issues
+
+### Linux (Ubuntu/Debian)
+- `host.docker.internal` doesn't work by default
+- Use `host-gateway` or Docker bridge IP (172.17.0.1)
+- May need to configure firewall for Docker
+
+### macOS
+- `host.docker.internal` works out of the box
+- Resource limits may need adjustment in Docker Desktop
+- File sharing permissions in Docker Desktop settings
+
+### Windows (WSL2)
+- Ensure WSL2 backend is enabled in Docker Desktop
+- `host.docker.internal` works but may have firewall issues
+- Check Windows Defender firewall rules
+
+## Quick Diagnostic Commands
+
+```bash
+# Check all Archon services
+docker compose ps
+
+# Check port availability
+netstat -tuln | grep -E "8181|8051|8052|3737"
+
+# Test service health
+curl http://localhost:${ARCHON_SERVER_PORT:-8181}/health
+curl http://localhost:${ARCHON_AGENTS_PORT:-8052}/health
+
+# View real-time logs
+docker compose logs -f
+
+# Restart everything
+docker compose down && docker compose up -d
+
+# Full reset
+docker compose down -v  # Warning: removes volumes
+docker compose up --build -d
+```
+
+## Environment Variable Reference
+
+```bash
+# Required
+SUPABASE_URL=           # Your Supabase instance URL
+SUPABASE_SERVICE_KEY=   # Service role key (not anon key)
+
+# Optional - Ports (defaults shown)
+ARCHON_SERVER_PORT=8181
+ARCHON_MCP_PORT=8051
+ARCHON_AGENTS_PORT=8052
+ARCHON_UI_PORT=3737
+
+# Optional - Services
+OPENAI_API_KEY=         # For OpenAI models
+OLLAMA_HOST=            # For local Ollama
+LOG_LEVEL=INFO          # DEBUG for more details
+```
+
+## Getting Help
+
+1. Check logs first: `docker compose logs [service-name]`
+2. Verify network: `docker network ls` and `docker network inspect`
+3. Test connectivity: Use curl or docker exec to test endpoints
+4. Check resource usage: `docker stats`
+5. Search existing issues on GitHub
+6. Create new issue with:
+   - Docker version: `docker --version`
+   - OS and version
+   - Full error logs
+   - docker-compose.yml (sanitized)
+   - .env (without secrets)
+
+## Common Fixes Summary
+
+| Problem | Quick Fix |
+|---------|-----------|
+| Connection timeout | Use shared network or bridge IP |
+| Port conflict | Change external ports in .env |
+| DOCKER_HOST error | Run: `unset DOCKER_HOST` |
+| Unhealthy container | Check logs, verify network |
+| Frontend API errors | Update VITE_API_URL |
+| Database errors | Run migrations |
+
+---
+
+*Remember: Most issues are network-related. When in doubt, check network configuration first!*
\ No newline at end of file
diff --git a/PR_DRAFT.md b/PR_DRAFT.md
new file mode 100644
index 0000000000..db9eae355e
--- /dev/null
+++ b/PR_DRAFT.md
@@ -0,0 +1,154 @@
+# Pull Request  Fix Linux Docker Networking and Add Flexible Port Configuration
+
+## Summary
+<!-- Provide a brief description of what this PR accomplishes -->
+This PR addresses critical deployment issues on Linux systems and adds flexible port configuration to avoid conflicts with existing services. These changes will help users successfully deploy Archon alongside other applications like Supabase projects and development servers.
+
+## Problems Solved
+
+### 1. 🐛 Docker Network Connectivity Issues on Linux
+**Problem:** Containers couldn't reach host services through `host.docker.internal` on Linux systems, causing Supabase connection timeouts.
+
+**Solution:** 
+- Use `host-gateway` instead of hardcoded IPs for better cross-platform compatibility
+- Document network configuration options for different deployment scenarios
+
+### 2. 🐛 Port Conflicts with Existing Services
+**Problem:** Default ports (3737, 8181, 8051, 8052) often conflict with other development tools.
+
+**Solution:**
+- Separate internal (container) ports from external (host) ports
+- Use environment variables for flexible external port mapping
+- Keep internal ports as defaults for simpler container-to-container communication
+
+### 3. 🐛 DOCKER_HOST Environment Conflicts
+**Problem:** Systems with Podman or custom Docker configurations fail due to DOCKER_HOST variable interference.
+
+**Solution:**
+- Add startup script that properly handles Docker environment
+- Document the need to unset DOCKER_HOST when needed
+
+### 4. 🐛 Supabase Network Isolation
+**Problem:** When using local Supabase, Archon containers on separate networks cannot communicate with Supabase services.
+
+**Solution:**
+- Provide configuration option to join existing Supabase network
+- Document both isolated and shared network approaches
+
+## Changes Made
+<!-- List the main changes in this PR -->
+1.Updated `docker-compose.yml`
+2. Created `start_archon.sh`
+3. Enhanced `.env.example`
+4.Created `DEPLOYMENT_TROUBLESHOOTING.md`
+
+
+### 1. Updated `docker-compose.yml`
+```yaml
+# Separated internal and external ports
+ports:
+  - "${ARCHON_SERVER_PORT:-8181}:8181"  # External can change, internal stays consistent
+
+# Fixed host.docker.internal for Linux
+extra_hosts:
+  - "host.docker.internal:host-gateway"  # Works on all platforms Tested only on ubuntu
+
+# Network configuration options
+networks:
+  app-network:
+    driver: bridge  # Default isolated network
+    # OR for Supabase integration:
+    # external: true
+    # name: supabase_network_name
+```
+
+### 2. Created `start_archon.sh`
+```bash
+#!/bin/bash
+# Handles environment setup and provides clear startup information
+unset DOCKER_HOST  # Prevents Podman/custom Docker conflicts
+docker compose up --build -d
+echo "Access points:"
+echo "  Web UI: http://localhost:${ARCHON_UI_PORT:-3737}"
+# ... etc
+```
+
+### 3. Enhanced `.env.example`
+```bash
+# Custom port configuration to avoid conflicts
+ARCHON_SERVER_PORT=8181  # Change to 9282 if 8181 is in use
+ARCHON_MCP_PORT=8051     # Change to 9151 if 8051 is in use
+ARCHON_AGENTS_PORT=8052  # Change to 9152 if 8052 is in use
+ARCHON_UI_PORT=3737      # Change to 4838 if 3737 is in use
+
+# Network configuration for local Supabase
+# For local Supabase: use container name
+# SUPABASE_URL=http://supabase_kong:8000
+# For remote Supabase: use public URL
+# SUPABASE_URL=https://your-project.supabase.co
+```
+
+### 4. Added Comprehensive Documentation
+- `DEPLOYMENT_TROUBLESHOOTING.md` - Common issues and solutions
+
+
+## Type of Change
+<!-- Mark the relevant option with an "x" -->
+- [X] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [X] Documentation update
+- [ ] Performance improvement
+- [ ] Code refactoring
+
+## Affected Services
+<!-- Mark all that apply with an "x" -->
+- [ ] Frontend (React UI)
+- [ ] Server (FastAPI backend)
+- [ ] MCP Server (Model Context Protocol)
+- [ ] Agents (PydanticAI service)
+- [ ] Database (migrations/schema)
+- [X] Docker/Infrastructure
+- [X ] Documentation site
+
+## Testing
+<!-- Describe how you tested your changes -->
+Tested on:
+- ✅ Ubuntu 24.04 with Docker 28.3.3
+- ✅ System with existing Supabase local deployment
+- ✅ System with Podman installed (DOCKER_HOST conflict resolved)
+- ✅ Multiple services running on default ports
+- [ ] All existing tests pass
+- [ ] Added new tests for new functionality
+- [X] Manually tested affected user flows
+- [X ] Docker builds succeed for all services
+
+### Test Evidence
+<!-- Provide specific test commands run and their results -->
+```bash
+
+DEPLOYMENT_SUCCESS.md
+
+# Example: python -m pytest tests/
+# Example: cd archon-ui-main && npm run test
+```
+## Breaking Changes
+None
+
+## Checklist
+<!-- Mark completed items with an "x" -->
+- [X ] My code follows the service architecture patterns
+- [ ] If using an AI coding assistant, I used the CLAUDE.md rules
+- [ ] I have added tests that prove my fix/feature works
+- [ ] All new and existing tests pass locally
+- [X] My changes generate no new warnings
+- [X ] I have updated relevant documentation
+- [X ] I have verified no regressions in existing features
+
+## Breaking Changes
+<!-- If this PR introduces breaking changes, describe them here -->
+None - all changes are backward compatible with existing deployments.
+
+## Additional Notes
+<!-- Any additional information that reviewers should know -->
+<!-- Screenshots, performance metrics, dependencies added, etc. -->
\ No newline at end of file
diff --git a/docker-compose.yml b/docker-compose.yml
index 28c3f95a04..391fef9a99 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -15,23 +15,28 @@ services:
       dockerfile: Dockerfile.server
       args:
         BUILDKIT_INLINE_CACHE: 1
+
         ARCHON_SERVER_PORT: ${ARCHON_SERVER_PORT:-8181}
     container_name: archon-server
+
     ports:
-      - "${ARCHON_SERVER_PORT:-8181}:${ARCHON_SERVER_PORT:-8181}"
+      - "${ARCHON_SERVER_PORT:-9282}:8181"
     environment:
-      - SUPABASE_URL=${SUPABASE_URL}
+      - SUPABASE_URL=http://supabase_kong_Archon:8000
       - SUPABASE_SERVICE_KEY=${SUPABASE_SERVICE_KEY}
       - OPENAI_API_KEY=${OPENAI_API_KEY:-}
       - LOGFIRE_TOKEN=${LOGFIRE_TOKEN:-}
       - SERVICE_DISCOVERY_MODE=docker_compose
       - LOG_LEVEL=${LOG_LEVEL:-INFO}
-      - ARCHON_SERVER_PORT=${ARCHON_SERVER_PORT:-8181}
+      - ARCHON_SERVER_PORT=8181
       - ARCHON_MCP_PORT=${ARCHON_MCP_PORT:-8051}
-      - ARCHON_AGENTS_PORT=${ARCHON_AGENTS_PORT:-8052}
+      - ARCHON_AGENTS_PORT=8052
     networks:
       - app-network
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
     volumes:
+
       - /var/run/docker.sock:/var/run/docker.sock # Docker socket for MCP container control
       - ./python/src:/app/src # Mount source code for hot reload
       - ./python/tests:/app/tests # Mount tests for UI test execution
@@ -39,23 +44,12 @@ services:
       - "host.docker.internal:host-gateway"
     command:
       [
-        "python",
-        "-m",
-        "uvicorn",
-        "src.server.main:socket_app",
-        "--host",
-        "0.0.0.0",
-        "--port",
-        "${ARCHON_SERVER_PORT:-8181}",
-        "--reload",
+        "python", "-m", "uvicorn", "src.server.main:socket_app", "--host",  "0.0.0.0", "--port", "${ARCHON_SERVER_PORT:-8181}", "--reload",
       ]
     healthcheck:
       test:
         [
-          "CMD",
-          "sh",
-          "-c",
-          'python -c "import urllib.request; urllib.request.urlopen(''http://localhost:${ARCHON_SERVER_PORT:-8181}/health'')"',
+          "CMD", "sh", "-c", 'python -c "import urllib.request; urllib.request.urlopen(''http://localhost:${ARCHON_SERVER_PORT:-8181}/health'')"',
         ]
       interval: 30s
       timeout: 10s
@@ -70,25 +64,28 @@ services:
       dockerfile: Dockerfile.mcp
       args:
         BUILDKIT_INLINE_CACHE: 1
+
         ARCHON_MCP_PORT: ${ARCHON_MCP_PORT:-8051}
     container_name: archon-mcp
     ports:
-      - "${ARCHON_MCP_PORT:-8051}:${ARCHON_MCP_PORT:-8051}"
+      - "${ARCHON_MCP_PORT:-9151}:8051"
     environment:
-      - SUPABASE_URL=${SUPABASE_URL}
+      - SUPABASE_URL=http://supabase_kong_Archon:8000
       - SUPABASE_SERVICE_KEY=${SUPABASE_SERVICE_KEY}
       - LOGFIRE_TOKEN=${LOGFIRE_TOKEN:-}
       - SERVICE_DISCOVERY_MODE=docker_compose
       - TRANSPORT=sse
       - LOG_LEVEL=${LOG_LEVEL:-INFO}
       # MCP needs to know where to find other services
-      - API_SERVICE_URL=http://archon-server:${ARCHON_SERVER_PORT:-8181}
-      - AGENTS_SERVICE_URL=http://archon-agents:${ARCHON_AGENTS_PORT:-8052}
-      - ARCHON_MCP_PORT=${ARCHON_MCP_PORT:-8051}
-      - ARCHON_SERVER_PORT=${ARCHON_SERVER_PORT:-8181}
-      - ARCHON_AGENTS_PORT=${ARCHON_AGENTS_PORT:-8052}
+      - API_SERVICE_URL=http://archon-server:8181
+      - AGENTS_SERVICE_URL=http://archon-agents:8052
+      - ARCHON_MCP_PORT=8051
+      - ARCHON_SERVER_PORT=8181
+      - ARCHON_AGENTS_PORT=8052
     networks:
       - app-network
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
     depends_on:
       - archon-server
       - archon-agents
@@ -97,10 +94,7 @@ services:
     healthcheck:
       test:
         [
-          "CMD",
-          "sh",
-          "-c",
-          'python -c "import socket; s=socket.socket(); s.connect((''localhost'', ${ARCHON_MCP_PORT:-8051})); s.close()"',
+          "CMD", "sh", "-c",  'python -c "import socket; s=socket.socket(); s.connect((''localhost'', ${ARCHON_MCP_PORT:-8051})); s.close()"',
         ]
       interval: 30s
       timeout: 10s
@@ -118,24 +112,22 @@ services:
         ARCHON_AGENTS_PORT: ${ARCHON_AGENTS_PORT:-8052}
     container_name: archon-agents
     ports:
-      - "${ARCHON_AGENTS_PORT:-8052}:${ARCHON_AGENTS_PORT:-8052}"
+      - "${ARCHON_AGENTS_PORT:-9152}:8052"
     environment:
-      - SUPABASE_URL=${SUPABASE_URL}
+      - SUPABASE_URL=http://supabase_kong_Archon:8000
       - SUPABASE_SERVICE_KEY=${SUPABASE_SERVICE_KEY}
       - OPENAI_API_KEY=${OPENAI_API_KEY:-}
       - LOGFIRE_TOKEN=${LOGFIRE_TOKEN:-}
       - SERVICE_DISCOVERY_MODE=docker_compose
       - LOG_LEVEL=${LOG_LEVEL:-INFO}
-      - ARCHON_AGENTS_PORT=${ARCHON_AGENTS_PORT:-8052}
+      - ARCHON_AGENTS_PORT=8052
     networks:
       - app-network
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
     healthcheck:
       test:
-        [
-          "CMD",
-          "sh",
-          "-c",
-          'python -c "import urllib.request; urllib.request.urlopen(''http://localhost:${ARCHON_AGENTS_PORT:-8052}/health'')"',
+        [ "CMD", "sh", "-c", 'python -c "import urllib.request; urllib.request.urlopen(''http://localhost:${ARCHON_AGENTS_PORT:-8052}/health'')"',
         ]
       interval: 30s
       timeout: 10s
@@ -169,4 +161,5 @@ services:
 
 networks:
   app-network:
-    driver: bridge
+    name: supabase_network_Archon
+    driver: bridge
\ No newline at end of file
diff --git a/start_archon.sh b/start_archon.sh
new file mode 100755
index 0000000000..1c725bef08
--- /dev/null
+++ b/start_archon.sh
@@ -0,0 +1,50 @@
+#!/bin/bash
+
+# Start Archon with proper Docker configuration
+
+echo "Starting Archon deployment..."
+
+# Unset DOCKER_HOST to use regular Docker daemon
+unset DOCKER_HOST
+
+# Check if Docker is running
+if ! docker info > /dev/null 2>&1; then
+    echo "Error: Docker daemon is not running. Please start Docker first."
+    exit 1
+fi
+
+# Clean up any existing containers
+echo "Cleaning up existing containers..."
+docker compose down 2>/dev/null
+
+# Build and start containers
+echo "Building and starting Archon containers..."
+# Wait on healthchecks with a configurable timeout (default 120s)
+docker compose up --build -d --wait --wait-timeout "${COMPOSE_WAIT_TIMEOUT:-120}"
+# Check container status
+echo ""
+echo "Container status:"
+docker compose ps
+
+# Display access URLs
+echo ""
+echo "========================================="
+echo "Archon is starting up!"
+echo "========================================="
+echo ""
+echo "Access points:"
+echo "  Web UI:        http://localhost:${ARCHON_UI_PORT:-4838}"
+echo "  API Server:    http://localhost:${ARCHON_SERVER_PORT:-9282}"
+echo "  MCP Server:    http://localhost:${ARCHON_MCP_PORT:-9151}"
+echo "  Agents:        http://localhost:${ARCHON_AGENTS_PORT:-9152}"
+echo ""
+echo "Supabase (local):"
+echo "  Studio:        http://localhost:54323"
+echo "  API:           http://localhost:54321"
+echo ""
+echo "To view logs:"
+echo "  docker compose logs -f"
+echo ""
+echo "To stop Archon:"
+echo "  docker compose down"
+echo "========================================="
\ No newline at end of file
diff --git a/supabase/.branches/_current_branch b/supabase/.branches/_current_branch
new file mode 100644
index 0000000000..88d050b190
--- /dev/null
+++ b/supabase/.branches/_current_branch
@@ -0,0 +1 @@
+main
\ No newline at end of file
diff --git a/supabase/.temp/cli-latest b/supabase/.temp/cli-latest
new file mode 100644
index 0000000000..322987f963
--- /dev/null
+++ b/supabase/.temp/cli-latest
@@ -0,0 +1 @@
+v2.34.3
\ No newline at end of file