Program Files
Complete guide to managing Loxone configuration files (.loxone) in Exosphere
Program files (.loxone files) are Loxone configuration files that contain the complete programming and setup for a Miniserver. Exosphere provides cloud storage and version management for these files, allowing you to store configuration files securely in the cloud, track version history automatically, and access files from anywhere via Loxone Config.
Quick Overview
For a visual overview of the Program Files interface, see Programs Overview.
Key Features
Version Control
Every upload creates a new version automatically:
- Automatic versioning - No manual version numbers needed
- Complete history - See all previous versions
- Metadata tracking - Who uploaded when
- Rollback capability - Download any previous version
Miniserver Association
Program files are linked to Miniservers by serial number:
- Automatic detection - Serial number read from file
- Smart grouping - All versions grouped by Miniserver
- Multi-device - One workspace can store files for multiple Miniservers
Loxone Config Integration
Direct integration with Loxone Config application:
- Cloud Connector - Save directly from Loxone Config
- Open in Config - One-click to open file in Loxone Config
- Automatic sync - Changes saved to Exosphere instantly
Prerequisites & Requirements
For End Users
Workspace Access
- Active Exosphere workspace (organizational or personal)
- Edit permissions or higher
Loxone Config (for full functionality)
- Loxone Config 16.0 or higher recommended
- Authenticated with Exosphere
Program Files
- Valid
.loxoneconfiguration files - Files under 100 MB
- Serial number embedded in file
License Requirements
No Exosphere license required to store program files! This feature is available in personal workspaces and unmanaged devices.
Full device management (backups, updates, monitoring) requires an active license.
Getting Started
Method 1: Upload via Web Interface (Quickest)
Steps
-
Navigate to Miniserver Details
- Go to Devices → Select your Miniserver
-
Go to Program Files Tab
- Click Program Files tab in device details
- First time: You'll see empty state
-
Upload File(s)
- Click Upload button
- Drag and drop
.loxonefile(s) - Or: Click to browse and select file(s)
- Multi-upload: Upload up to 10 files at once
-
Wait for Processing
-
Verify Upload
- New program appears in list
- Version shows as V1
Bulk Upload
You can upload multiple program files at once! The system automatically detects serial numbers and groups files by device.
Core Operations
1. Viewing Program Files
Steps
- Navigate to Devices in main menu
- Click on Miniserver name
- Click Program Files tab
What You See
Program List View:
- Grouped by program name (same Miniserver serial)
- Most recent version shown first
- Version count badge (e.g., "3 Versions")
- Quick actions for latest version
Interface Details
For more details on the Programs interface and available actions, see Programs Overview.
2. Downloading Program Files
Method A: Download Single Version
- Navigate to Program Files tab
- Locate the version you want
- Click Download button (↓ icon)
- File downloads to browser's download folder
- Filename format:
original-name.loxone
Method B: Download Latest Version
- In collapsed view, click Download on the right
- Downloads most recent version immediately
3. Opening in Loxone Config
Steps
- Navigate to Program Files tab
- Click Open in Loxone Config button (📂 icon)
- Browser prompts for permission (first time)
- Allow opening in Loxone Config
- Loxone Config launches and opens file
4. Renaming Program Files
Steps
- Navigate to Program Files tab
- Click Edit button (✏️ icon) next to program name
- Modal opens with current name
- Enter new name
- Click Save
Rename vs Replace
Renaming only changes the display name in Exosphere. The file content and serial number remain unchanged.
5. Deleting Program Files
Delete Single Version
- Expand program to show all versions
- Locate version to delete
- Click Delete button (🗑️ icon)
- Confirm deletion in modal
- Version removed from list
Delete All Versions
- Locate program with multiple versions
- Click Delete All button (visible when expanded)
- Warning: This deletes ALL versions permanently
- Confirm in modal dialog
- All versions removed
Permanent Deletion
Deleted files cannot be recovered! Make sure you have local backups before deleting important configurations.
Consider downloading versions before deletion if you might need them later.
Best Practices
Regular Saves
DO:
- Save to cloud after significant changes
- Create versions at project milestones
- Save before testing on physical Miniserver
DON'T:
- Wait until project completion to save
- Overwrite local files without cloud backup
- Forget to document what changed
Naming Conventions
Good naming examples:
Villa Schmidt - Living Area
Hotel Lobby - Floor 1 - 2025-01
Office Building - Main Config v3Poor naming examples:
test
config123
final final FINAL v2Related Documentation
- Programs Overview - Visual guide to the Program Files interface
- Miniserver Details - Complete Miniserver management guide
- Backups - Automatic backup management