Exosphere Documentation

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 .loxone configuration 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

  1. Navigate to Miniserver Details

    • Go to Devices → Select your Miniserver
  2. Go to Program Files Tab

    • Click Program Files tab in device details
    • First time: You'll see empty state
  3. Upload File(s)

    • Click Upload button
    • Drag and drop .loxone file(s)
    • Or: Click to browse and select file(s)
    • Multi-upload: Upload up to 10 files at once
  4. Wait for Processing

  5. 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

  1. Navigate to Devices in main menu
  2. Click on Miniserver name
  3. 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

  1. Navigate to Program Files tab
  2. Locate the version you want
  3. Click Download button (↓ icon)
  4. File downloads to browser's download folder
  5. Filename format: original-name.loxone

Method B: Download Latest Version

  1. In collapsed view, click Download on the right
  2. Downloads most recent version immediately


3. Opening in Loxone Config

Steps

  1. Navigate to Program Files tab
  2. Click Open in Loxone Config button (📂 icon)
  3. Browser prompts for permission (first time)
  4. Allow opening in Loxone Config
  5. Loxone Config launches and opens file

4. Renaming Program Files

Steps

  1. Navigate to Program Files tab
  2. Click Edit button (✏️ icon) next to program name
  3. Modal opens with current name
  4. Enter new name
  5. 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

  1. Expand program to show all versions
  2. Locate version to delete
  3. Click Delete button (🗑️ icon)
  4. Confirm deletion in modal
  5. Version removed from list

Delete All Versions

  1. Locate program with multiple versions
  2. Click Delete All button (visible when expanded)
  3. Warning: This deletes ALL versions permanently
  4. Confirm in modal dialog
  5. 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 v3

Poor naming examples:

test
config123
final final FINAL v2