Research User Management Guide¶

CloudWorkstation v0.5.0 Administrator and Power User Guide

This guide provides comprehensive information for managing research users in CloudWorkstation environments, including setup, administration, troubleshooting, and best practices for individual, team, and institutional deployments.

Quick Reference¶

Essential Commands (v0.5.0)¶

# Research User Management
cws research-user create <username>                    # Create research user
cws research-user list                                 # List all research users
cws research-user status <username>                   # Check user status
cws research-user delete <username>                   # Remove research user

# SSH Key Management
cws research-user ssh-key generate <username> ed25519 # Generate SSH key pair
cws research-user ssh-key import <username> <pubkey>  # Import existing key
cws research-user ssh-key list <username>             # List user's keys
cws research-user ssh-key delete <username> <key-id>  # Remove SSH key

# Instance Integration
cws launch <template> <instance> --research-user <username>  # Launch with research user
cws research-user provision <username> --instance <name>     # Provision user on instance
cws research-user status <username> --instance <name>        # Check user on instance

# EFS and Storage
cws volumes create <name>                             # Create EFS volume
cws volumes mount <volume> <instance>                 # Mount EFS volume
cws volumes list                                      # List EFS volumes

Key File Locations¶

~/.cloudworkstation/
├── research-users/           # Research user configurations
│   └── <profile-id>/
│       └── <username>.json   # User config
├── ssh-keys/                 # SSH key storage
│   └── <profile-id>/
│       └── <username>/
│           ├── <key-id>.pub  # Public key
│           └── <key-id>.json # Key metadata
└── uid-allocations.json      # UID/GID allocation cache

UID/GID Ranges¶

System Users: 1000-4999 (templates and system accounts)
Research Users: 5000-5999 (persistent research identities)
Research Groups: 5000-5099 (research, efs-users, etc.)

Setup and Configuration¶

Initial Setup¶

Verify CloudWorkstation Installation

cws --version
# Should show v0.5.0 or later for research user support

Check Profile Configuration

cws profiles list
cws profiles show current

Initialize Research User System

# Create base directories (automatic on first use)
mkdir -p ~/.cloudworkstation/research-users
mkdir -p ~/.cloudworkstation/ssh-keys

Configuration Files¶

Research User Configuration¶

Location: ~/.cloudworkstation/research-users/<profile-id>/<username>.json

{
  "username": "alice",
  "uid": 5001,
  "gid": 5000,
  "full_name": "Alice Smith",
  "email": "alice@example.com",
  "home_directory": "/efs/home/alice",
  "efs_volume_id": "fs-1234567890abcdef0",
  "efs_mount_point": "/efs",
  "shell": "/bin/bash",
  "create_home_dir": true,
  "ssh_public_keys": [
    "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5... alice@cloudworkstation"
  ],
  "secondary_groups": ["research", "efs-users", "sudo", "docker"],
  "sudo_access": true,
  "docker_access": true,
  "created_at": "2025-09-28T10:30:00Z",
  "profile_owner": "personal-research"
}

SSH Key Configuration¶

Location: ~/.cloudworkstation/ssh-keys/<profile-id>/<username>/<key-id>.json

{
  "key_id": "alice-ed25519-1727519400",
  "fingerprint": "SHA256:abc123def456...",
  "public_key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5... alice@cloudworkstation",
  "comment": "alice@cloudworkstation-personal",
  "created_at": "2025-09-28T10:30:00Z",
  "from_profile": "personal-research",
  "auto_generated": true
}

User Management Operations¶

Creating Research Users¶

Basic User Creation¶

# Create research user with automatic UID assignment
cws research-user create alice

# Create with custom full name and email
cws research-user create alice --full-name "Alice Smith" --email "alice@university.edu"

# Create with SSH key generation
cws research-user create alice --generate-ssh-key

Advanced User Creation¶

# Create with specific shell
cws research-user create alice --shell /bin/zsh

# Create with custom groups
cws research-user create alice --groups research,docker,jupyter-users

# Create with EFS configuration
cws research-user create alice --efs-volume fs-1234567890abcdef0 --efs-mount /efs

Modifying Research Users¶

# Update user information
cws research-user update alice --full-name "Dr. Alice Smith"
cws research-user update alice --email "alice.smith@university.edu"

# Add/remove groups
cws research-user update alice --add-groups jupyter-users
cws research-user update alice --remove-groups docker

# Change shell
cws research-user update alice --shell /bin/zsh

Listing and Inspecting Users¶

# List all research users in current profile
cws research-user list

# List with detailed information
cws research-user list --detailed

# Show specific user information
cws research-user show alice

# Show user with SSH keys and instance history
cws research-user show alice --include-keys --include-instances

Example Output¶

Research Users (Profile: personal-research)
┌──────────┬─────┬─────┬────────────┬─────────────────┬────────────┐
│ Username │ UID │ GID │ SSH Keys   │ Last Used       │ Instances  │
├──────────┼─────┼─────┼────────────┼─────────────────┼────────────┤
│ alice    │5001 │5000 │ 2          │ 2h ago          │ 3          │
│ bob      │5023 │5000 │ 1          │ 1d ago          │ 1          │
│ carol    │5067 │5000 │ 3          │ 5d ago          │ 0          │
└──────────┴─────┴─────┴────────────┴─────────────────┴────────────┘

Deleting Research Users¶

# Delete user (with confirmation)
cws research-user delete alice

# Force delete without confirmation
cws research-user delete alice --force

# Delete user and clean up SSH keys
cws research-user delete alice --cleanup-keys

# Delete user but preserve EFS home directory
cws research-user delete alice --preserve-home

SSH Key Management¶

Key Generation¶

# Generate Ed25519 key (recommended)
cws research-user ssh-key generate alice ed25519

# Generate RSA key for compatibility
cws research-user ssh-key generate alice rsa

# Generate with custom comment
cws research-user ssh-key generate alice ed25519 --comment "alice-laptop-2025"

Key Import and Export¶

# Import existing public key
cws research-user ssh-key import alice ~/.ssh/id_rsa.pub

# Import with custom comment
cws research-user ssh-key import alice ~/.ssh/id_rsa.pub --comment "Personal laptop key"

# Export all keys for backup
cws research-user ssh-key export alice --output alice-keys-backup.tar.gz

# Export single key
cws research-user ssh-key export alice --key-id <key-id> --output alice-key.pub

Key Management¶

# List all SSH keys for user
cws research-user ssh-key list alice

# Show detailed key information
cws research-user ssh-key show alice <key-id>

# Delete specific key
cws research-user ssh-key delete alice <key-id>

# Rotate keys (generate new, deactivate old)
cws research-user ssh-key rotate alice ed25519

SSH Key Listing Example¶

SSH Keys for alice (Profile: personal-research)
┌────────────────────────┬─────────────────────────────┬─────────────┬───────────────┐
│ Key ID                 │ Fingerprint                 │ Created     │ Last Used     │
├────────────────────────┼─────────────────────────────┼─────────────┼───────────────┤
│ alice-ed25519-12345    │ SHA256:abc123def456...      │ 2025-09-25  │ 2h ago        │
│ alice-rsa-67890        │ SHA256:def456ghi789...      │ 2025-09-20  │ 1d ago        │
│ imported-abc123        │ SHA256:ghi789jkl012...      │ 2025-09-15  │ 1w ago        │
└────────────────────────┴─────────────────────────────┴─────────────┴───────────────┘

Authorized Keys Generation¶

# Generate authorized_keys content for user
cws research-user ssh-key authorized-keys alice

# Save to file
cws research-user ssh-key authorized-keys alice > alice_authorized_keys

# Generate for multiple users
cws research-user ssh-key authorized-keys alice,bob,carol > team_authorized_keys

EFS Integration¶

EFS Volume Management¶

# Create EFS volume for research users
cws volumes create research-home --type efs --performance generalPurpose

# Create high-performance EFS for shared data
cws volumes create shared-datasets --type efs --performance provisioned --throughput 500

# List EFS volumes
cws volumes list --type efs

Home Directory Setup¶

# Configure research user with EFS home
cws research-user create alice --efs-volume research-home --efs-mount /efs

# Update existing user with EFS
cws research-user update alice --efs-volume research-home --efs-mount /efs

# Create home directory structure
cws research-user setup-home alice --create-directories projects,scratch,archive

EFS Mounting and Permissions¶

# Mount EFS volume to instance
cws volumes mount research-home my-instance --mount-point /efs

# Check mount status
cws volumes status research-home

# Set up permissions for research users
cws research-user setup-efs-permissions alice --volume research-home

EFS Directory Structure¶

/efs/                                    # EFS mount point
├── home/                                # Research user homes (755 root:efs-users)
│   ├── alice/                           # alice's home (750 alice:research)
│   │   ├── .bashrc                      # Personal shell config
│   │   ├── .ssh/                        # SSH keys (700 alice:research)
│   │   │   └── authorized_keys          # (600 alice:research)
│   │   ├── projects/                    # Research projects
│   │   │   ├── ml-analysis/
│   │   │   └── data-processing/
│   │   ├── scratch/                     # Temporary work
│   │   └── archive/                     # Completed projects
│   └── bob/                             # bob's home (750 bob:research)
└── shared/                              # Shared directories (755 root:research)
    ├── datasets/                        # Shared datasets (775 root:research)
    ├── libraries/                       # Code libraries (775 root:research)
    ├── notebooks/                       # Jupyter notebooks (775 root:research)
    └── team-projects/                   # Collaborative projects (775 root:research)
        ├── project-alpha/               # Specific project (775 root:research)
        └── project-beta/

Instance Provisioning¶

Provisioning Research Users¶

# Provision research user on existing instance
cws research-user provision alice --instance my-python-instance

# Provision with custom EFS mount
cws research-user provision alice --instance my-instance --efs-volume research-data --mount-point /data

# Provision multiple users
cws research-user provision alice,bob,carol --instance shared-instance

# Provision with specific SSH user
cws research-user provision alice --instance my-instance --ssh-user ubuntu --ssh-key ~/.ssh/my-key

Instance Launch with Research Users¶

# Launch instance with research user
cws launch "Python Machine Learning" ml-work --research-user alice

# Launch with multiple research users
cws launch "R Research Environment" shared-analysis --research-users alice,bob

# Launch with EFS volume
cws launch "Python ML" gpu-training --research-user alice --efs-volume shared-datasets

Provisioning Status and Monitoring¶

# Check research user status on instance
cws research-user status alice --instance ml-work

# Monitor provisioning progress
cws research-user provision-status <job-id>

# List all research user instances
cws research-user instances alice

# Check what instances a user can access
cws research-user list-access alice

Status Output Example¶

Research User Status: alice on ml-work
┌─────────────────┬─────────────────────────────────────────┐
│ Property        │ Value                                   │
├─────────────────┼─────────────────────────────────────────┤
│ Username        │ alice                                   │
│ UID/GID         │ 5001/5000                              │
│ Home Directory  │ /efs/home/alice                        │
│ EFS Mounted     │ Yes (/efs)                             │
│ SSH Accessible  │ Yes (2 keys configured)                │
│ Last Login      │ 2025-09-28 10:45:00                   │
│ Active Processes│ 3                                      │
│ Disk Usage      │ 2.3 GB                                 │
│ Instance Uptime │ 5h 23m                                 │
└─────────────────┴─────────────────────────────────────────┘

Multi-User Collaboration¶

Team Setup¶

# Create team research users
cws research-user create alice --full-name "Alice Smith" --email "alice@lab.edu"
cws research-user create bob --full-name "Bob Johnson" --email "bob@lab.edu"
cws research-user create carol --full-name "Carol Davis" --email "carol@lab.edu"

# Create shared EFS volume
cws volumes create team-research --type efs --performance provisioned --throughput 300

# Setup shared directories
cws research-user setup-collaboration --users alice,bob,carol --volume team-research

Collaborative Workflows¶

Scenario 1: Sequential Collaboration¶

# Alice starts analysis
alice@python-instance: cd /efs/shared/project-alpha
alice@python-instance: python data_preprocessing.py
alice@python-instance: git add .; git commit -m "Initial data preprocessing"

# Bob continues with statistical analysis
bob@r-instance: cd /efs/shared/project-alpha
bob@r-instance: R -e "source('statistical_analysis.R')"
bob@r-instance: git add .; git commit -m "Statistical analysis complete"

# Carol creates visualizations
carol@viz-instance: cd /efs/shared/project-alpha
carol@viz-instance: python generate_plots.py
carol@viz-instance: git add .; git commit -m "Added data visualizations"

Scenario 2: Parallel Collaboration¶

# Multiple users working simultaneously
alice@gpu-1: cd /efs/shared/datasets && python preprocess_batch_1.py
bob@gpu-2: cd /efs/shared/datasets && python preprocess_batch_2.py
carol@cpu-1: cd /efs/shared/analysis && R -e "source('summary_stats.R')"

# Files automatically have correct ownership
ls -la /efs/shared/datasets/
-rw-r--r-- 1 alice research batch_1_processed.parquet
-rw-r--r-- 1 bob   research batch_2_processed.parquet

ls -la /efs/shared/analysis/
-rw-r--r-- 1 carol research summary_statistics.csv

Access Control and Permissions¶

# Create project-specific groups
cws research-user create-group ml-team --members alice,bob
cws research-user create-group viz-team --members alice,carol
cws research-user create-group stats-team --members bob,carol

# Set directory permissions for groups
cws research-user set-permissions /efs/shared/ml-project --group ml-team --mode 775
cws research-user set-permissions /efs/shared/visualizations --group viz-team --mode 775
cws research-user set-permissions /efs/shared/statistics --group stats-team --mode 775

Monitoring and Analytics¶

Usage Monitoring¶

# Show research user activity summary
cws research-user analytics --profile personal-research

# Show detailed usage for specific user
cws research-user analytics alice --detailed

# Show team usage summary
cws research-user analytics --users alice,bob,carol --timeframe 30d

# Export usage data
cws research-user analytics alice --export csv --output alice-usage.csv

Analytics Output Example¶

Research User Analytics (Last 30 days)
┌─────────────────┬─────────────────────────────────────────┐
│ Metric          │ alice                                   │
├─────────────────┼─────────────────────────────────────────┤
│ Instances Used  │ 8                                      │
│ Total Login Time│ 47h 32m                                │
│ Files Created   │ 1,247                                  │
│ Data Stored     │ 15.7 GB                               │
│ SSH Connections │ 156                                    │
│ Peak Concurrent │ 3 instances                           │
│ Most Used Template│ Python ML (62% of time)             │
│ Collaboration   │ 3 users (bob, carol, david)          │
└─────────────────┴─────────────────────────────────────────┘

System Health Monitoring¶

# Check UID/GID allocation status
cws research-user system-status --uid-allocations

# Check SSH key health
cws research-user system-status --ssh-keys

# Check EFS integration status
cws research-user system-status --efs-integration

# Full system health check
cws research-user system-status --full

Audit and Security Monitoring¶

# Show recent research user activities
cws research-user audit-log --recent 24h

# Show specific user's audit trail
cws research-user audit-log alice --timeframe 7d

# Show SSH key usage patterns
cws research-user audit-log --ssh-keys --timeframe 30d

# Export audit logs
cws research-user audit-log --export json --output audit-2025-09.json

Troubleshooting¶

Common Issues and Solutions¶

1. SSH Access Problems¶

Problem: Cannot SSH to instance as research user

# Diagnosis
cws research-user status alice --instance my-instance
cws research-user ssh-key list alice

# Solutions
# Check if user is provisioned
cws research-user provision alice --instance my-instance

# Verify SSH keys are installed
ssh ubuntu@my-instance "sudo cat /efs/home/alice/.ssh/authorized_keys"

# Re-provision if needed
cws research-user provision alice --instance my-instance --force

2. File Permission Issues¶

Problem: Cannot access files created by other research users

# Diagnosis
ssh alice@instance "ls -la /efs/shared/problematic-file"
ssh alice@instance "groups"

# Solutions
# Check if user is in research group
cws research-user update alice --add-groups research

# Fix file permissions
ssh alice@instance "sudo chgrp research /efs/shared/problematic-file"
ssh alice@instance "sudo chmod g+r /efs/shared/problematic-file"

3. EFS Mount Issues¶

Problem: EFS home directory not accessible

# Diagnosis
ssh alice@instance "mount | grep efs"
ssh alice@instance "ls -la /efs/"

# Solutions
# Check EFS mount status
cws volumes status research-home

# Remount EFS volume
cws volumes mount research-home my-instance --mount-point /efs

# Fix EFS permissions
cws research-user setup-efs-permissions alice --volume research-home

4. UID Conflicts¶

Problem: Research user has different UID on different instances

# Diagnosis
ssh alice@instance1 "id alice"  # Should be 5001
ssh alice@instance2 "id alice"  # Should also be 5001

# Solutions
# Check UID allocation
cws research-user show alice --include-uid

# Re-provision user with correct UID
cws research-user provision alice --instance instance2 --force

# Clear and regenerate UID cache
cws research-user system-maintenance --clear-uid-cache

Diagnostic Commands¶

# Comprehensive system diagnostics
cws research-user diagnose

# Diagnose specific user
cws research-user diagnose alice

# Diagnose specific instance
cws research-user diagnose --instance my-instance

# Generate diagnostic report
cws research-user diagnose --report diagnostic-report.txt

Recovery Procedures¶

Recover Lost Research User¶

# Recreate research user from backup
cws research-user restore alice --from-backup alice-backup.json

# Recreate with same UID (if known)
cws research-user create alice --force-uid 5001

# Restore SSH keys
cws research-user ssh-key import-backup alice alice-keys-backup.tar.gz

Reset Research User System¶

# Clear all research user data (DESTRUCTIVE)
cws research-user system-reset --confirm

# Reset specific profile
cws research-user system-reset --profile personal-research --confirm

# Reset UID allocations only
cws research-user system-reset --uid-allocations --confirm

Security Best Practices¶

SSH Key Security¶

Use Ed25519 Keys: Prefer Ed25519 over RSA for new key generation
```
cws research-user ssh-key generate alice ed25519
```

Regular Key Rotation: Rotate SSH keys periodically

# Monthly key rotation
cws research-user ssh-key rotate alice ed25519 --deactivate-old-after 30d

Monitor Key Usage: Track SSH key usage patterns

cws research-user audit-log alice --ssh-keys --timeframe 7d

Access Control¶

Principle of Least Privilege: Only grant necessary permissions

# Remove docker access if not needed
cws research-user update alice --remove-groups docker

Regular Access Reviews: Review user permissions quarterly

cws research-user list --detailed --include-permissions

Group-Based Permissions: Use groups for shared access

cws research-user create-group project-alpha --members alice,bob

Data Security¶

EFS Encryption: Use encrypted EFS volumes

cws volumes create secure-research --type efs --encrypted

Home Directory Isolation: Ensure proper home directory permissions

# Verify home directory permissions are 750
ssh alice@instance "ls -ld /efs/home/alice"

Shared Directory Controls: Implement proper shared directory permissions

# Shared directories should be 755 or 775
ssh alice@instance "ls -ld /efs/shared/*"

Monitoring and Compliance¶

Enable Audit Logging: Track all research user activities

# Enable comprehensive audit logging
cws config set research-user.audit-log.enabled true
cws config set research-user.audit-log.level detailed

Regular Security Scans: Check for security issues

cws research-user security-scan --profile personal-research

Compliance Reporting: Generate compliance reports

cws research-user compliance-report --format pdf --output compliance-2025-Q3.pdf

Institutional Deployment¶

Large-Scale Setup¶

University Department (100+ Users)¶

# Batch user creation from CSV
cws research-user batch-create --from-csv students-cs501.csv

# Template optimization for education
cws research-user configure-education --class cs501 --template "Python ML" --users-from-csv students.csv

# Automated EFS setup for classes
cws research-user setup-class-storage cs501 --volume-size 1TB --shared-quota 100GB-per-user

Research Institution (500+ Users)¶

# Department-based organization
cws research-user create-department computer-science --quota 10TB
cws research-user create-department biology --quota 25TB
cws research-user create-department physics --quota 15TB

# Automated provisioning pipeline
cws research-user setup-auto-provisioning --ldap-integration --department-quotas

Integration with External Systems¶

LDAP/Active Directory Integration¶

# Configure LDAP authentication
cws research-user configure-ldap --server ldap.university.edu --base-dn "ou=users,dc=university,dc=edu"

# Sync users from LDAP
cws research-user ldap-sync --department computer-science

# Map LDAP groups to research user groups
cws research-user map-ldap-groups "cn=CS Students,ou=groups,dc=university,dc=edu" students

Single Sign-On (SSO) Integration¶

# Configure SAML SSO
cws research-user configure-sso --provider saml --metadata-url https://sso.university.edu/metadata

# Configure OAuth integration
cws research-user configure-sso --provider oauth --client-id university-cws --discovery-url https://oauth.university.edu/.well-known

Policy Management¶

Institutional Policies¶

# Create policy templates for different user types
cws research-user create-policy undergraduate --max-instances 2 --max-storage 10GB --templates "Python ML,R Research"
cws research-user create-policy graduate --max-instances 5 --max-storage 100GB --templates "*"
cws research-user create-policy faculty --max-instances unlimited --max-storage 1TB --templates "*"

# Apply policies to users
cws research-user apply-policy alice undergraduate
cws research-user apply-policy bob graduate

Compliance and Governance¶

# Enable data residency controls
cws research-user configure-compliance --data-residency US --encryption required

# Set retention policies
cws research-user configure-retention --inactive-users 365d --archive-data 7y

# Configure audit requirements
cws research-user configure-audit --level comprehensive --retention 10y --export-format syslog

Advanced Configuration¶

Performance Tuning¶

UID Allocation Optimization¶

# Configure UID allocation for large deployments
cws config set research-user.uid-base 10000
cws config set research-user.uid-range 50000

# Enable UID allocation caching
cws config set research-user.uid-cache.enabled true
cws config set research-user.uid-cache.ttl 24h

EFS Performance Optimization¶

# Configure EFS performance mode for research workloads
cws config set research-user.efs.performance-mode provisioned
cws config set research-user.efs.throughput-mode provisioned
cws config set research-user.efs.throughput-mib 500

SSH Key Management Optimization¶

# Enable SSH key caching for faster access
cws config set research-user.ssh-key.cache.enabled true
cws config set research-user.ssh-key.cache.ttl 1h

# Configure key rotation policies
cws config set research-user.ssh-key.rotation.enabled true
cws config set research-user.ssh-key.rotation.interval 90d

Custom Integration¶

API Integration¶

// Example Go code for custom research user integration
package main

import (
    "github.com/scttfrdmn/cloudworkstation/pkg/research"
    "github.com/scttfrdmn/cloudworkstation/pkg/profile"
)

func main() {
    // Create research user service
    profileMgr := profile.NewManager()
    service := research.CreateDefaultResearchUserService(profileMgr)

    // Create research user programmatically
    user, err := service.CreateResearchUser("alice", &research.CreateResearchUserOptions{
        GenerateSSHKey: true,
    })
    if err != nil {
        panic(err)
    }

    // Provision on instance
    req := &research.ProvisionInstanceRequest{
        InstanceID:   "i-1234567890abcdef0",
        InstanceName: "ml-workstation",
        PublicIP:     "54.123.45.67",
        Username:     "alice",
        SSHKeyPath:   "/home/admin/.ssh/id_rsa",
        SSHUser:      "ubuntu",
    }

    response, err := service.ProvisionUserOnInstance(context.Background(), req)
    if err != nil {
        panic(err)
    }

    fmt.Printf("Provisioning successful: %v\n", response.Success)
}

Plugin System (Future)¶

# Install research user plugins
cws plugin install research-user-ldap-sync
cws plugin install research-user-quota-manager
cws plugin install research-user-analytics-dashboard

# Configure plugins
cws plugin configure research-user-ldap-sync --server ldap.university.edu

Backup and Disaster Recovery¶

Backup Procedures¶

# Backup all research user configurations
cws research-user backup --profile personal-research --output research-users-backup.tar.gz

# Backup SSH keys
cws research-user backup-ssh-keys --profile personal-research --output ssh-keys-backup.tar.gz

# Backup EFS data
cws volumes snapshot research-home --description "Weekly backup $(date +%Y-%m-%d)"

Recovery Procedures¶

# Restore research users from backup
cws research-user restore --from-backup research-users-backup.tar.gz

# Restore SSH keys
cws research-user restore-ssh-keys --from-backup ssh-keys-backup.tar.gz

# Restore EFS from snapshot
cws volumes restore research-home --from-snapshot snap-1234567890abcdef0

Conclusion¶

Research User Management in CloudWorkstation v0.5.0 provides a comprehensive foundation for collaborative research computing. This guide covers:

✅ Complete Setup: From initial configuration to advanced deployment
✅ User Management: Creation, modification, and lifecycle management
✅ Security: SSH keys, access control, and compliance
✅ Collaboration: Multi-user workflows and team management
✅ Monitoring: Analytics, troubleshooting, and system health
✅ Scale: From individual researchers to institutional deployments

The research user system transforms CloudWorkstation from a single-user tool into a collaborative research platform while maintaining the simplicity and flexibility that makes CloudWorkstation powerful.

For additional support: - 📚 Technical Documentation: Phase 5A Research User Architecture - 👥 User Guide: Research Users User Guide - 🏗️ Architecture Guide: Dual User Architecture - 🐛 Support: GitHub Issues

Document Version: 1.0 Last Updated: September 28, 2025 CloudWorkstation Version: v0.5.0+