Cloud Foundry Deployment

Deploy S4Kit to SAP BTP Cloud Foundry for scalable, production-ready hosting.

Prerequisites

Cloud Foundry CLI installed
Logged in: cf login
Target set: cf target -o <org> -s <space>

Architecture

Application	Purpose	Port
`s4kit-backend`	Admin API + Auth	8080
`s4kit-proxy`	SDK proxy service	8080
`s4kit-frontend`	Next.js dashboard	8080

All apps use the Bun buildpack.

Deployment

Create Services

# PostgreSQL & Redis (external or SAP BTP managed)
cf create-user-provided-service s4kit-postgres -p '{"uri":"postgresql://..."}'
cf create-user-provided-service s4kit-redis -p '{"uri":"redis://..."}'

# Secrets
cf create-user-provided-service s4kit-secrets -p "{
  \"ENCRYPTION_KEY\": \"$(openssl rand -hex 32)\",
  \"BETTER_AUTH_SECRET\": \"$(openssl rand -base64 32)\"
}"

Deploy Apps

# From monorepo root
cf push -f packages/platform/backend/manifest.yml
cf push -f packages/platform/proxy/manifest.yml

# Frontend (requires build)
cd packages/platform/frontend
NEXT_PUBLIC_API_URL=https://s4kit-backend.YOUR-DOMAIN ./deploy-cf.sh

Verify

cf apps
curl https://s4kit-backend.YOUR-DOMAIN/health
curl https://s4kit-proxy.YOUR-DOMAIN/health/live

Configuration

Variable	Default	Description
`MODE`	`selfhost`	`selfhost` or `saas` (multi-tenant)
`FRONTEND_URL`	manifest	Frontend URL for CORS
`COOKIE_DOMAIN`	auto	Cross-subdomain cookies

Scaling

cf scale s4kit-proxy -i 3 -m 512M    # More API throughput
cf scale s4kit-backend -i 2 -m 256M  # More admin users

XSUAA (SAP Identity)

cd packages/platform/backend
cf create-service xsuaa application s4kit-xsuaa -c xs-security.json

Role templates: S4KitOwner, S4KitAdmin, S4KitDeveloper

Troubleshooting

Issue	Solution
Module errors	`cf restage s4kit-backend --no-cache`
Redis refused	Check `cf env s4kit-backend \| grep redis`
Cookie issues	Set `COOKIE_DOMAIN` manually
Wrong API URL	Rebuild frontend with correct `NEXT_PUBLIC_API_URL`

Full CF Guide

Complete Cloud Foundry deployment guide →

​Prerequisites

​Architecture

​Deployment

​Configuration

​Scaling

​XSUAA (SAP Identity)

​Troubleshooting