Settings Overview

The HomeDock OS Settings panel allows you to configure essential system options and personalize your environment. These settings cover user credentials, networking, theme preferences, and system behaviors, providing flexibility to suit individual requirements.

Configuration Options

The Configuration Options section provides all the essential settings to customize and manage your HomeDock OS experience. From updating your login credentials to setting default storage locations, this section is designed to give you control over fundamental aspects of your HomeDock environment. Each option here ensures that HomeDock OS operates seamlessly and aligns with your specific requirements.

Username

Displays the current username for HomeDock OS. To update the username, simply modify this field and save the settings.

Note

After changing your HomeDock OS username, you will be prompted to log in again to confirm your identity.

Change Password

Toggle the Change Password option to update the password. Enter a new password and confirm it by retyping it in the Confirm Password field.

Note

Passwords must be at least 6 characters long. Ensure your password is strong to maintain the security of your HomeDock OS instance.

HomeDock UI Port

Specify the port that HomeDock OS uses for its interface. By default, this is set to 80, the regular HTTP port. You can change it if you need to avoid conflicts with other services or comply with your own network policies. A service restart is needed in order to work on a new HomeDock UI Port.

Note

If there is no certificate in /DATA/SSLCerts, the application will run on HTTP port 80 (unencrypted). If a valid certificate is present in /DATA/SSLCerts, the application will automatically enable HTTPS. By default, it will operate also on port 80 with SSL encryption for compatibility, but we strongly recommend using port 443 for HTTPS to maintain aesthetic and functional standards. In controlled environments or specific applications, HTTPS on any open port can function correctly if properly configured.

Dynamic DNS

Set your custom Dynamic DNS (DDNS) for easier remote access. This field accepts your preferred DDNS, such as yourdomain.freedns.com, allowing you to access HomeDock OS via a consistent hostname.

Default External Drive

Choose the default external drive for storage and data backups. Typically, this field points to a specific device path, such as /dev/sdb2, enabling HomeDock OS to handle additional storage seamlessly.

Theme Selection

Customize the look and feel of your HomeDock OS with these theme options:

• Default: The classic, light-themed interface for a clean and simple appearance.
• Noir: A dark mode option designed for comfortable viewing in low-light environments.
• Aero+: A dynamic and customizable theme, offering a sleek design with support for custom background images, allowing you to upload your own wallpapers for a personalized touch.

Choose your preferred theme by selecting the corresponding radio button.

HomeDock Behavior

Adjust the system’s behavior using these toggle options:

• Enable access on homedock.local: Recommended Enabling this option allows the system to be accessed via homedock.local on private local networks. Requires a system restart.
• Run on Development Mode: Not Recommended Enable this mode to activate development features. Will be deprecated in the future. Requires a system restart.
• Delete Old Data on App Update: Automatically clears outdated application data when updates are applied, ensuring efficient use of storage.
• Delete Old Data on App Uninstall: Removes all residual data when an application is uninstalled, keeping your storage organized.

Note

The Run on Development Mode feature is intended for development purposes only and it will be deprecated soon. Currently, Development Mode operates with Flask, which is not suitable for production environments. In normal operation, HomeDock OS utilizes Hypercorn as a backend server.

Actions

• Save Settings: Applies all modifications made in the settings panel.
• Cancel: Discards any changes and exits the settings panel without saving.

By leveraging these configuration options, you can tailor HomeDock OS to meet specific needs, streamline access, and optimize system performance.