Administrator Settings Guide

Status: Complete
For: System Administrators
Updated: August 23, 2025

Overview

The Sasha Studio administrative interface provides system-wide configuration options that affect all users. These settings are designed for immediate application without requiring server restarts.

Accessing Admin Settings

Prerequisites

• Admin user account (contact your system administrator)
• Access to Sasha Studio web interface

Navigation

1. Login to Sasha Studio with admin credentials
2. Click Settings (gear icon) in the top navigation
3. Select tabs to configure different aspects:
   • System Health - Monitor system resources and performance
   • General - Configure system-wide operational settings
   • AI Admin - Manage AI provider configuration

System Health Monitoring

Disk Usage

The System Health tab displays real-time disk usage with visual indicators:

• 🟢 Green (< 70%): Normal operation, plenty of space available
• 🟡 Yellow (70-85%): Monitor usage, consider cleanup
• 🔴 Red (> 85%): Low disk space warning - immediate attention required

Refresh Rate: Updates automatically every 5 minutes

Performance Metrics

• CPU Usage: Current processor load across available cores
• Memory Usage: RAM consumption with available memory display
• Service Status: Database, Claude API, and WebSocket connection health

General Settings Configuration

File Management

Maximum Upload Size

• Current Default: 100MB per file
• Configurable Range: 1MB - 5GB (5,120MB)
• Applies: Immediately to new uploads (no restart required)
• Affects: All file upload endpoints across the application

To Change Upload Limit:

1. Navigate to Settings → General tab
2. Locate File Management section
3. Enter desired size in MB (e.g., 200 for 200MB)
4. Setting saves automatically when you change the value
5. New uploads will use the updated limit immediately

Validation Rules

• Minimum: 1MB (prevents system issues)
• Maximum: 5GB (5,120MB) (prevents storage overload)
• Integer Values: Only whole numbers accepted
• Real-time Display: Current setting always visible

System Controls

Debug Mode

• Purpose: Enable verbose logging for troubleshooting
• Default: Disabled (recommended for production)
• Toggle: Click button to enable/disable instantly
• Affects: Server log verbosity, useful for support investigations

When to Enable:

• Investigating user-reported issues
• Debugging upload or processing problems
• Working with technical support

Important: Disable after debugging to maintain system performance

Usage Examples

Scenario 1: Increasing Upload Limit for Large Documents

Current: 100MB limit is preventing legal document uploads
Action: Change to 500MB in General Settings
Result: Large contracts and presentations can now be uploaded
Timeline: Effective immediately for new uploads

Scenario 2: Monitoring Disk Space

Observation: Disk usage at 78% (yellow warning)
Action: Review uploaded files and implement cleanup
Prevention: Monitor usage weekly via System Health tab
Alert: Will show red warning at 85%+

Scenario 3: Troubleshooting Upload Issues

Issue: Users report failed uploads
Action: Enable Debug Mode in General Settings
Investigation: Check server logs for detailed error information
Resolution: Disable Debug Mode after issue resolved

API Information for Developers

Endpoints

• GET /api/admin/general-settings - Retrieve current settings
• POST /api/admin/general-settings - Update settings
• POST /api/admin/general-settings/reset - Reset to defaults

Settings Structure

{
  "file": {
    "maxUploadSize": 104857600,  // 100MB in bytes
    "maxWorkspaceSize": 1073741824,  // 1GB in bytes
    "retentionDays": 7
  },
  "session": {
    "timeoutHours": 24,
    "maxConcurrent": 5,
    "autoSaveSeconds": 30
  },
  "system": {
    "debugMode": false,
    "maintenanceMode": false,
    "analytics": true,
    "errorReporting": true
  }
}

Security Considerations

Admin Access Control

• Restriction: Only users with is_admin flag can access settings
• Validation: Server-side permission checks on all endpoints
• Audit: All setting changes logged with user ID and timestamp

Setting Validation

• Range Checks: Upload sizes validated against safe limits
• Type Validation: Ensures correct data types for all settings
• Error Handling: Graceful fallback to defaults if corruption occurs

Troubleshooting

Settings Not Saving

1. Check Network: Ensure stable internet connection
2. Verify Admin Status: Confirm admin privileges are active
3. Browser Console: Check for JavaScript errors
4. Try Refresh: Reload page and attempt again

Disk Usage Not Displaying

1. Cross-Platform: Works on Linux/macOS, limited on Windows
2. Permissions: Ensure server has filesystem access
3. Fallback: Shows "unknown" if detection fails

Upload Limits Not Applied

1. Cache: New settings apply to new uploads only
2. Browser Cache: Hard refresh may be needed (Ctrl+F5)
3. Error Messages: Check if files exceed the new limit

Best Practices

Production Environment

• Conservative Limits: Start with lower upload limits, increase as needed
• Regular Monitoring: Check System Health weekly
• Debug Mode: Keep disabled unless actively troubleshooting
• Documentation: Record setting changes and rationale

Capacity Planning

• Disk Space: Monitor usage trends to predict storage needs
• Upload Patterns: Track file size distributions to optimize limits
• User Feedback: Collect input on upload limit adequacy

Support Information

Getting Help

• Admin Documentation: Refer to this guide first
• System Health: Use built-in monitoring for diagnostics
• Debug Logs: Enable Debug Mode for detailed error information
• Contact Support: Include current settings and error messages

Reporting Issues

When contacting support, include:

1. Current Settings: Screenshot of General Settings tab
2. System Health: Current resource usage levels
3. Error Messages: Exact text of any error dialogs
4. Steps to Reproduce: Detailed sequence that caused the issue
5. Browser Information: Chrome/Firefox version and OS

---

Version: 1.0
Last Updated: August 23, 2025
Next Review: September 2025