Control Hub Overview

The Control Hub in HomeDock OS provides a centralized interface for managing all installed applications. This powerful feature enables users to have complete control over their applications, from configuration exports to real-time monitoring. Whether you need to troubleshoot an application, replicate its setup on another system, or simply keep it updated, the Control Hub is designed to streamline these tasks. Below is a detailed guide covering each feature available within the Control Hub to help you make the most of your HomeDock OS experience.

Features

HomeDock OS offers a variety of management tools through the Control Hub, designed to give you flexibility and control over each application. Here’s a breakdown of what each tool does and how it can assist in managing your applications effectively:

Export Config

• Export Config allows you to download a YAML configuration file containing the exact settings of an application. This export is particularly useful if you want to replicate the setup on another HomeDock OS system or need a backup for disaster recovery. By maintaining a copy of the application’s configuration, you ensure that recreating or transferring it is a straightforward process.

Note

Only the configuration settings are included in the exported file. Internal application data, such as files within /DATA/ApplicationName, are not included in the export. If you need to preserve specific application data, ensure it is backed up separately.

Edit Config

• Edit Config opens a configuration editor for the selected application, where you can modify settings or adjust its linked docker-compose file. This tool offers several options to control how and when changes are applied:
  • Save and Recreate: Re-deploys the application with the updated configuration immediately, applying any modifications. This option is useful when significant changes are made, as it ensures the application reflects the latest setup.
  • Save: Stores the updated configuration without redeploying the application. These changes will take effect on the next application update, allowing you to prepare configurations in advance.
  • Close: Exits the editor without saving any changes, preserving the current configuration as it is.

Note

The Edit Config functionality will soon feature a visual editor, replacing the plain text editor to make configuration adjustments more intuitive.

View Logs

• View Logs provides a real-time view into the internal logs of each application, which is essential for debugging and monitoring. By default, only the most recent entries are shown to prevent overload, with longer logs automatically truncated. A Real-time Log Update switch is available, allowing users to view dynamic log updates. This feature is particularly valuable for observing application behavior and pinpointing issues as they occur.

Replace Link

• Replace Link allows you to import a configuration file previously exported with Export Config. This feature leverages the “Compose Link” in HomeDock OS—a master module that maintains internal configurations for each application. The Replace Link function is ideal for restoring previous settings or syncing applications with a specific configuration, enabling streamlined updates or real-time configuration modifications. This is especially useful if you are reverting to an older version or implementing a known stable configuration.

Additional Notes

• The Compose Link system in HomeDock OS is an innovative feature that consolidates and centralizes configuration management. This enables users to manage multiple applications from a single interface, ensuring quick updates and seamless configuration changes across the board.
• When planning to transfer applications between systems, always ensure that each configuration is saved through Export Config. This practice maintains consistent setups and preserves important application details for future use.

With these tools, the Control Hub empowers users to manage applications efficiently, maintain consistency, and ensure stability across different HomeDock OS instances. Whether for personal or enterprise use, the Control Hub’s features streamline application management to enhance productivity and reliability.