🚀 Icarus Phase 2 — Deployment Instructions

cd /home/hoffmann_admin/.openclaw/workspace/services/icarus

# 1. Source environment
source staging.env

# 2. Test import
python3 -c "from icarus.core.api import app; print('✅ Import OK')"

# 3. Test data directories exist
mkdir -p $DATA_DIR $CHROMA_DB_PATH $RADICALE_DATA_DIR

# 4. Local test (optional)
python3 -m uvicorn icarus.core.api:app --host 127.0.0.1 --port 8001 &
curl http://127.0.0.1:8001/health
kill %1  # Stop test server

sudo tee /etc/systemd/system/icarus-staging.service << 'EOF'
[Unit]
Description=Icarus Staging API (Port 8001)
After=network.target

[Service]
Type=simple
User=hoffmann_admin
WorkingDirectory=/home/hoffmann_admin/.openclaw/workspace/services/icarus
Environment=ICARUS_ENV=staging
EnvironmentFile=/home/hoffmann_admin/.openclaw/workspace/services/icarus/staging.env
ExecStart=/home/hoffmann_admin/.local/bin/uvicorn icarus.core.api:app --host 0.0.0.0 --port 8001 --log-level info
Restart=always
RestartSec=5
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable icarus-staging.service

sudo systemctl start icarus-staging.service

sudo systemctl status icarus-staging.service
sudo journalctl -u icarus-staging.service -f

# From any machine (or phone)
curl -s https://icarus-test.hoffdesk.com/health | python3 -m json.tool

{
    "status": "ok",
    "env": "icarus-staging",
    "version": "0.0.1",
    "stage": "phase-2-ready"
}

# On Beelink
ss -tlnp | grep 8001
# Expected: 0.0.0.0:8001 (LISTEN)

# Production on 8000 should still work
curl -s https://family.hoffdesk.com/ | head -5
curl -s https://notes.hoffdesk.com/api/blog/posts | head -5

# Check logs
sudo journalctl -u icarus-staging.service --no-pager -n 50

# Common issues:
# - ImportError: Run `source staging.env` in service file context
# - Port 8001 in use: `sudo lsof -i :8001` then `sudo kill <pid>`
# - Permission denied: Check file ownership of icarus/ directory

# Check if service is actually running on port 8001
curl http://127.0.0.1:8001/health

# If that works but Cloudflare 502s:
# - Check cloudflared config: `cat ~/.cloudflared/config.yml`
# - Verify `icarus-test.hoffdesk.com` route is FIRST in ingress
# - Restart cloudflared: `sudo systemctl restart cloudflared`

# If "No module named icarus":
# - Add PYTHONPATH to service file:
Environment=PYTHONPATH=/home/hoffmann_admin/.openclaw/workspace/services/icarus:$PYTHONPATH

# Then:
sudo systemctl daemon-reload
sudo systemctl restart icarus-staging.service