proxmox/docs/archive/deployment-reports/SERVICE_DEPLOYMENT_STATUS.md

Service Deployment Status

Date: 2026-01-20
Status: 🟡 IN PROGRESS - Services partially deployed

---

Current Deployment Status

Service	VMID	IP	Status	Notes
PostgreSQL	7803	192.168.11.53	✅ Running	Database configured
Keycloak	7802	192.168.11.52	⚠️ In Progress	Installation needs completion
API	7800	192.168.11.50	⏸️ Pending	Waiting for Keycloak
Portal	7801	192.168.11.51	⏸️ Pending	Waiting for API/Keycloak

---

✅ Completed

1. All Containers Deployed:

   • ✅ All 4 containers running
   • ✅ All IPs correctly assigned (192.168.11.50-53)
   • ✅ Network connectivity fixed (vmbr0)
   • ✅ Internet connectivity working

2. PostgreSQL:

   • ✅ Installed and configured
   • ✅ Database sankofa created
   • ✅ User sankofa created
   • ✅ Network access configured (192.168.11.0/24)
   • ✅ Service running

3. Network Configuration:

   • ✅ All containers on vmbr0 (VLAN 11)
   • ✅ Gateway: 192.168.11.11 (host)
   • ✅ Internet connectivity working
   • ✅ DNS configured

---

🟡 In Progress

Keycloak Setup

• ✅ Java 21 installed
• ✅ Keycloak database created
• ⚠️ Keycloak download/installation incomplete
• ⚠️ Keycloak build needs completion
• ⚠️ Service configuration needs completion

Issues:

• Keycloak download/extraction failing
• Service file needs proper configuration

---

⏸️ Pending

API Deployment

• ⏸️ Node.js 18 installation needed
• ⏸️ pnpm installation needed
• ⏸️ Project files copy needed
• ⏸️ Dependencies installation needed
• ⏸️ Environment configuration needed
• ⏸️ Database migrations needed
• ⏸️ Build and service setup needed

Portal Deployment

• ⏸️ Node.js 18 installation needed
• ⏸️ pnpm installation needed
• ⏸️ Project files copy needed
• ⏸️ Dependencies installation needed
• ⏸️ Build (Next.js) needed
• ⏸️ Service setup needed

---

🔧 Issues to Resolve

1. Keycloak Installation

Issue: Keycloak download/extraction not completing properly

Solution:

# Manually download and install Keycloak
ssh root@192.168.11.11 "pct exec 7802 -- bash -c 'cd /opt && wget -q https://github.com/keycloak/keycloak/releases/download/24.0.0/keycloak-24.0.0.tar.gz && tar -xzf keycloak-24.0.0.tar.gz && mv keycloak-24.0.0 keycloak && chmod +x keycloak/bin/kc.sh'"

# Build Keycloak
ssh root@192.168.11.11 "pct exec 7802 -- bash -c 'cd /opt/keycloak && export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64 && ./bin/kc.sh build --db postgres'"

# Configure and start service

2. DNS for npm Registry

Issue: Containers can't resolve npm registry

Solution: Fixed - DNS updated to 8.8.8.8, 1.1.1.1

3. pnpm Installation

Issue: npm can't reach registry

Solution: After DNS fix, install pnpm:

ssh root@192.168.11.11 "pct exec 7800 -- bash -c 'npm install -g pnpm'"

---

📋 Next Steps

Immediate Actions:

1. Complete Keycloak Setup:

   • Download and extract Keycloak manually
   • Build Keycloak with PostgreSQL support
   • Configure service file
   • Start Keycloak service
   • Verify health endpoint

2. Deploy API Service:

   • Install Node.js 18 and pnpm
   • Copy API project files
   • Install dependencies
   • Configure environment
   • Run database migrations
   • Build and start service

3. Deploy Portal Service:

   • Install Node.js 18 and pnpm
   • Copy Portal project files
   • Install dependencies
   • Build Next.js application
   • Configure and start service

After Services Deployed:

4. Verify Services:

   • Test health endpoints
   • Verify inter-service connectivity
   • Test API endpoints
   • Test Portal access

5. Update Cutover Plan:

   • Document actual IPs/ports
   • Update TBD placeholders
   • Prepare for NPMplus cutover

---

📝 Service Endpoints

PostgreSQL

• IP: 192.168.11.53
• Port: 5432
• Database: sankofa
• Status: ✅ Running

Keycloak (When Complete)

• IP: 192.168.11.52
• Port: 8080
• URL: http://192.168.11.52:8080
• Health: http://192.168.11.52:8080/health/ready
• Status: ⚠️ In Progress

API (When Complete)

• IP: 192.168.11.50
• Port: 4000
• URL: http://192.168.11.50:4000
• GraphQL: http://192.168.11.50:4000/graphql
• Health: http://192.168.11.50:4000/health
• Status: ⏸️ Pending

Portal (When Complete)

• IP: 192.168.11.51
• Port: 3000
• URL: http://192.168.11.51:3000
• Status: ⏸️ Pending

---

🔗 Related Documentation

• Deployment Guide: scripts/DEPLOYMENT_README_R630-01.md
• Cutover Plan: docs/04-configuration/SANKOFA_CUTOVER_PLAN.md
• Network Fix: CONNECTIVITY_FIXED.md

---

Last Updated: 2026-01-20
Status: 🟡 Services partially deployed
Priority: Continue with Keycloak, API, Portal deployment