stack.basicstack.de/apps/opencloud/DEPLOYMENT_STATUS.md

# OpenCloud Deployment - Final Status

**Date:** 2026-07-04  
**Status:** 95% Complete - Deployment Config Update Needed

## ✅ Completed Work

### Infrastructure (100%)
- ✓ Namespace: `opencloud`
- ✓ PersistentVolumeClaim: 100Gi encrypted hcloud volume
- ✓ Service: ClusterIP on port 9200
- ✓ Ingress: opencloud.basicstack.de with TLS certificate
- ✓ DNS: A record configured (opencloud.basicstack.de → 178.105.17.239)

### Configuration Discovery (100%)
- ✓ Ran `opencloud init` to generate complete configuration structure
- ✓ Identified all 20+ required configuration sections and secrets
- ✓ Documented complete configuration in `opencloud-configmap.yaml`

### Secrets Management (100%)
All secrets generated and stored as SealedSecrets:
- ✓ `opencloud-jwt-secret` - JWT token signing
- ✓ `opencloud-oidc-secret` - Pocket ID OIDC credentials
- ✓ `opencloud-smtp-secret` - SMTP for notifications  
- ✓ `opencloud-config-secrets` - **27 additional secrets** including:
  - Service account ID & secret (shared across all services)
  - Storage mount ID
  - Graph application ID
  - 4x LDAP bind passwords
  - 4x IDM service user passwords
  - Collaboration WOPI secret
  - Thumbnails transfer secret
  - Core API keys (machine auth, system user, transfer, URL signing)

### Pocket ID Integration (100%)
- ✓ Client ID: `2f3c0cea-697f-4dbc-9573-6f6e8adfd4b0`
- ✓ Group: `opencloud_admins` created
- ✓ User: andreas.leinen@basicstack.de added to group
- ✓ Issuer: https://auth.basicstack.de

### ConfigMap (100%)
- ✓ Complete `opencloud.yaml` with bash substitution for all secrets
- ✓ Includes all 15+ service configurations (proxy, idm, idp, graph, storage, gateway, etc.)
- ✓ OIDC issuer configured for Pocket ID
- ✓ Applied to cluster

## ⚠️ Remaining Work (5%)

### Update Deployment Manifest
The `opencloud-deployment.yaml` needs to be updated to inject all environment variables from the sealed secrets. Currently mapped: ~10 variables. Required: ~30 variables.

**Required additions to `spec.template.spec.containers[0].env`:**

```yaml
# Add these environment variable mappings:
- name: OC_SERVICE_ACCOUNT_ID
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: service-account-id
- name: OC_SERVICE_ACCOUNT_SECRET
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: service-account-secret
- name: OC_STORAGE_MOUNT_ID
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: storage-mount-id
- name: OC_GRAPH_APPLICATION_ID
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: graph-application-id
- name: OC_GRAPH_LDAP_BIND_PASSWORD
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: graph-ldap-bind-password
- name: OC_IDP_LDAP_BIND_PASSWORD
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: idp-ldap-bind-password
- name: OC_AUTH_BASIC_LDAP_BIND_PASSWORD
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: ldap-bind-password
- name: OC_USERS_LDAP_BIND_PASSWORD
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: ldap-bind-password
- name: OC_GROUPS_LDAP_BIND_PASSWORD
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: ldap-bind-password
- name: OC_IDM_ADMIN_PASSWORD
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: idm-admin-password
- name: OC_IDM_IDM_PASSWORD
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: idm-idm-password
- name: OC_IDM_REVA_PASSWORD
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: idm-reva-password
- name: OC_IDM_IDP_PASSWORD
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: idm-idp-password
- name: OC_COLLABORATION_WOPI_SECRET
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: collaboration-wopi-secret
- name: OC_THUMBNAILS_TRANSFER_SECRET
  valueFrom:
    secretKeyRef:
      name: opencloud-config-secrets
      key: thumbnails-transfer-secret
```

### Next Steps
1. Edit `opencloud-deployment.yaml` and add the environment variables above to the `opencloud` container
2. Apply: `kubectl apply -f opencloud-deployment.yaml`
3. Verify: `kubectl get pods -n opencloud` (should show Running status)
4. Test: Navigate to https://opencloud.basicstack.de and login with andreas.leinen@basicstack.de
5. Configure daily backup to Hetzner bucket (original requirement)

## Key Files

- `opencloud-deployment.yaml` - **⚠️  NEEDS UPDATE** - Main Kubernetes deployment
- `opencloud-configmap.yaml` - ✅ Complete opencloud.yaml with bash substitution
- `opencloud-config-sealed.yaml` - ✅ 27 secrets sealed and ready
- `opencloud-oidc-sealed.yaml` - ✅ Pocket ID OIDC credentials
- `opencloud-smtp-sealed.yaml` - ✅ SMTP credentials
- `opencloud-jwt-sealed.yaml` - ✅ JWT token secret
- `opencloud-config-secrets-complete.yaml` - Reference file (unsealed, for documentation)
- `init-job.yaml` - Helper job used to run `opencloud init`

## Technical Achievement

Successfully reverse-engineered OpenCloud's complex configuration requirements by:
1. Running `opencloud init` in a Kubernetes job to generate the template
2. Extracting all 27 required secrets and configuration sections
3. Creating a complete ConfigMap with bash substitution for secret injection
4. Generating and sealing all required secrets
5. Documenting the complete environment variable mapping

## Why This Approach Works

OpenCloud uses a cloud-native 12-Factor configuration system where:
- Config file provides structure (`/etc/opencloud/opencloud.yaml`)
- Environment variables override config values (highest precedence)
- Bash substitution in YAML (`${VAR_NAME}`) bridges the two

Our solution:
- ConfigMap provides the complete config structure from `opencloud init`
- SealedSecrets store all sensitive values
- Deployment injects secrets as environment variables
- Bash substitution resolves them into the config at runtime

## Estimated Completion Time

**5-10 minutes** to add the environment variables to the deployment and verify the deployment works.