File Manager
The File Manager (Finder) is the heart of RoqueOS's file system. It lets you browse, organize and manage your files across multiple storage sources — from cloud storage (Firebase) to physical disks on your server mapped via Docker.
Storage Sources
The Finder works with three types of storage, depending on your setup:
☁️ Cloud Storage (Default)
Available to all users, no server needed. Your files are securely stored in Firebase Storage, linked to your account.
- Capacity: Defined by your storage quota
- Sync: Automatic across all logged-in devices
- Access: From anywhere with internet
💾 Server Disks Server
When connected to a RoqueOS Server, you can map real folders from your computer or host server into the Finder. They appear as virtual disks in the left sidebar.
To set up disks, see the Volumes (Disks) guide.
🌐 Network Storage (SMB/NFS) Server
Access network shares from your local network (NAS, Samba shares, NFS) directly in the Finder. Ideal for accessing network drives, Synology/QNAP NAS and Windows shared folders.
Navigation
Sidebar
The left panel shows all your storage sources:
- Storage — Cloud storage root folder
- Disks — Mapped server volumes (e.g.,
Movies,Downloads,Projects) - Network — Connected network shares
Path Bar
At the top of the window, the breadcrumb path bar shows where you are and allows quick navigation to parent folders.
View Modes
Switch between two view modes:
- 📋 List — Detailed view with name, size, type and modification date
- 📦 Grid — View with large icons and image previews
Context Menu
Right-click (or long-press on mobile) on any file or folder to access the full context menu:
Available Actions
| Action | Description |
|---|---|
| Open | Opens the file with the appropriate application |
| Open with... | Choose which application to use |
| Rename | Change the file or folder name |
| Copy | Copy to clipboard |
| Move | Move to another location |
| Delete | Send to trash |
| Download | Download the file to your device |
| Compress | Create a ZIP file with selected items |
| Info | View details like size, type and dates |
File Upload
There are several ways to upload files to the Finder:
Drag and Drop
Drag files from your computer directly into the Finder window. A drop zone will appear indicating where the file will be saved.
Upload Button
Click the ⬆️ Upload button in the toolbar to select files from your device.
Create New Folder
Click the 📁+ button or use the context menu to create new folders and organize your files.
Integration with Other Apps
The Finder automatically identifies each file type and opens it with the correct application:
| File Type | App That Opens |
|---|---|
.jpg, .png, .gif, .webp, .svg | Image Viewer |
.mp3, .wav, .ogg, .flac | Music Player |
.mp4, .webm, .mkv | Video Player |
.pdf | Roque PDF |
.txt, .log, .csv | Text Editor |
.js, .py, .html, .css, .json | Roque Code |
Integration with VS Code Server
When connected to the server, the same files you see in the Finder are also accessible in the integrated VS Code. This means you can:
- Browse and organize files in the Finder
- Open and edit code in VS Code
- Both work on the same filesystem of the Ubuntu container
Mobile Features
On mobile, the Finder adapts with:
- Long press to open the context menu (replaces right-click)
- Responsive layout that adjusts to the device screen
- Navigation gestures — swipe to go back to the previous folder
- Multi-select — tap and hold to select multiple files
Tips & Shortcuts
QUICK TIPS
- Double-click a folder to enter it
- Double-click a file to open with the default app
- Use the search bar to find files quickly
- Drag files between folders to move them
- Select multiple files by holding
Ctrl(orCmdon Mac)