Workspace File Management
The Workspace File Management backend manages user files in the JupyterHub workspace — browsing, uploading, downloading, and organizing files that live in S3. It is the service the BFF calls for all file operations in the Cogrion workspace UI.
What It Does
- Lists and browses files in the workspace S3 bucket
- Handles upload and download requests from the Cogrion UI
- Keeps a PostgreSQL record of file metadata and sharing state
Components
| Component | Description |
|---|---|
| Service | Custom backend (workspace-file-management-backend) — Keycloak OIDC, REST API |
| PostgreSQL | File metadata, sharing records |
Storage
Has an IRSA role with S3 read/write access to the workspace bucket ({platform_id}-workspace). Files are stored in S3; the service provides the API layer over them.
Authentication
Keycloak OIDC via a dedicated OAuth client.
Go Deeper
- JupyterHub — notebooks where files are used; rclone syncs files between S3 and local notebook filesystem
- Storages — the workspace S3 bucket this service reads and writes
- BFF API — proxies file requests from the Cogrion UI to this service