Repository navigation
User Guide
This guide covers everything you need to know as a regular user of Flowcase, including how to launch and use droplets, manage instances, and navigate the interface.
- Open your web browser and navigate to your Flowcase instance URL
- Login with your username and password provided by your administrator
- Dashboard - You'll be taken to the main dashboard where you can see available droplets
[!INFO] Password Management: Currently, users cannot change their own passwords. If you need a password change, contact your administrator. Self-service password changes are planned for future releases.
When you first login, you'll see:
- Navigation bar with your username and logout option
- Main content area showing available droplets
- Running instances (if any) at the bottom of the screen
Droplets are pre-configured containerized applications that you can launch and use through your web browser. Each droplet represents a specific application or desktop environment.
Each droplet displays:
- Name - The application or environment name
- Description - What the droplet contains
- Preview Image - Visual representation of the application
- Launch Button - Click to start an instance
- Browse available droplets on the main dashboard
- Click on a droplet you want to use
- Review the information in the popup modal
- Click "Launch" to start a new instance
- Wait for provisioning - The system will create and configure your container
- Automatic redirect - You'll be taken to the droplet interface once ready
Once your droplet launches, you'll see:
- Full-screen application or desktop environment
- Control sidebar (toggle with the handle on the left)
- Connection information and controls
- File management options (if enabled)
The control panel provides access to:
- Reconnect - Refresh the connection
- Disconnect - Close the session
- Fullscreen - Toggle fullscreen mode
- Upload Files - Drag and drop or browse to upload
- Download Files - Access files from the container
- File Browser - Navigate the container filesystem
- Resolution - Adjust screen resolution
- Keyboard Layout - Change keyboard mapping
- Audio - Configure audio settings
| Shortcut | Action |
|---|---|
F11 |
Toggle fullscreen |
Ctrl+Alt+F |
Toggle control panel |
Ctrl+Alt+R |
Reconnect |
Ctrl+Alt+D |
Disconnect |
- Open the control panel by clicking the sidebar handle
- Navigate to "Upload" section
- Drag and drop files into the upload area, or
- Click browse to select files from your computer
- Monitor upload progress in the progress bar
- Files appear in the container's designated upload folder
- Access the file browser in the control panel
- Navigate to the file you want to download
- Right-click on the file and select "Download", or
- Use the download button if available
-
Upload Folder:
/home/user/uploads/(or as configured) -
Desktop:
/home/user/Desktop/ -
Documents:
/home/user/Documents/ -
Downloads:
/home/user/Downloads/
Warning
File Persistence: By default, files in droplet instances are temporary and will be lost when the instance is destroyed. Only upload/download files you need to preserve between sessions. Contact your administrator about persistent storage options if available.
Running instances appear at the bottom of the dashboard:
- Thumbnail preview - Live screenshot of the running application
- Instance name - Shows the droplet name
- Quick actions - Connect or destroy options
- Click the thumbnail to view the instance popup
- Click "Connect" to open the instance in a new window
- Direct URL - Each instance has a unique URL for direct access
- Click the thumbnail to open the popup
- Click "Destroy" to terminate the instance
- Confirm the action in the popup dialog
- Data loss warning - All unsaved work will be lost
- Provisioning - Container is being created and configured
- Starting - Application is initializing
- Running - Instance is ready for use
- Stopping - Instance is being shut down
- Destroyed - Instance and data are removed
Warning
Data Loss Prevention: When you destroy an instance, ALL data inside the container is permanently lost unless persistent storage is configured. Always download important files before destroying instances.
Access display settings through the control panel:
- Choose from preset resolutions
- Custom resolution input
- Automatic browser detection
- Fit to window
- Original size
- Custom zoom levels
Configure audio settings:
- Enable/Disable audio streaming
- Volume control
- Audio codec selection (if available)
Customize input settings:
- Keyboard layout selection
- Mouse sensitivity
- Touch screen support (mobile devices)
Flowcase works on mobile devices with some considerations:
- Touch navigation - Use touch gestures for mouse input
- Virtual keyboard - On-screen keyboard for text input
- Orientation - Landscape mode recommended
- Zoom controls - Pinch to zoom in/out
- Touch keyboard toggle
- Gesture controls for right-click and scrolling
- Fullscreen mode for better experience
- Automatic save - Session state is preserved
- Reconnection - Resume your session after disconnection
- Timeout - Sessions expire after inactivity (configured by admin)
- Multiple droplets - Run several instances simultaneously
- Browser tabs - Open instances in different tabs
- Session isolation - Each instance is independent
Issue: Cannot connect to droplet Solutions:
- Refresh the browser page
- Check internet connection
- Try a different browser
- Contact administrator
Issue: Slow performance Solutions:
- Close unnecessary browser tabs
- Check network bandwidth
- Reduce screen resolution
- Contact administrator about server resources
Issue: Screen appears cut off Solutions:
- Adjust browser zoom level
- Change droplet resolution
- Try fullscreen mode
- Use landscape orientation on mobile
Issue: Blurry or pixelated display Solutions:
- Increase resolution setting
- Check network connection quality
- Disable browser extensions
- Try hardware acceleration
Issue: Files won't upload Solutions:
- Check file size limits
- Verify file type permissions
- Try smaller files first
- Contact administrator
Issue: Uploaded files not visible Solutions:
- Check upload folder location
- Refresh file browser
- Verify upload completion
- Contact administrator
- Close unused applications within the droplet
- Use appropriate resolution for your screen
- Maintain good network connection
- Clear browser cache regularly
- Save work frequently within applications
- Download important files before destroying instances
- Use cloud storage for persistent data when possible
- Backup critical work externally - do not rely on instance storage
Important
File Persistence Policy: Unless your administrator has configured persistent storage for specific droplets, all files and changes within instances are temporary. Plan your workflow accordingly and always save important work externally.
- Log out when finished
- Don't share credentials with others
- Use strong passwords (if you can change them)
- Be cautious with sensitive data
- Report issues to administrators
- Refresh the page - Solves many temporary issues
- Try different browser - Compatibility check
- Check network connection - Ensure stable internet
- Clear browser cache - Remove temporary files
When contacting your administrator, provide:
- Your username
- Droplet name you're trying to use
- Error messages (screenshot if possible)
- Browser and version you're using
- Steps to reproduce the issue
Check with your administrator about:
- Scheduled maintenance times
- System resource limits
- Available droplets and updates
- Policy changes or new features
- Bookmarking instances - Save direct links to running instances
- Multi-monitor setup - Use multiple browser windows
- Keyboard shortcuts - Learn efficiency shortcuts
- Custom workflows - Develop personal usage patterns
- Screen recording - Use browser extensions to record sessions
- Note taking - Keep external notes about your work
- Time tracking - Monitor usage for productivity
- Collaboration - Share screens through browser sharing
| Action | Steps |
|---|---|
| Launch droplet | Dashboard → Click droplet → Launch |
| Connect to instance | Bottom bar → Click thumbnail → Connect |
| Upload file | Control panel → Upload → Drag/drop |
| Destroy instance | Thumbnail → Destroy → Confirm |
| Logout | Username menu → Logout |
| Shortcut | Action |
|---|---|
F11 |
Fullscreen |
Ctrl+Alt+F |
Toggle sidebar |
Ctrl+Alt+R |
Reconnect |
Need more help? Check the FAQ or Troubleshooting Guide for additional assistance.