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 Port Access

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 valid 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 on port 443 with SSL compatibility. We strongly recommend using port 443 for HTTPS to maintain security and functionality standards. In controlled environments or specific applications, HTTPS can function correctly on any open port if properly configured, such as any available application with a valid mapped SSL Certificate.

Hostname

Set your custom Dynamic DNS (DDNS) for easier remote access. This field accepts your preferred DynamicDNS, it’s defaulted to get.homedock.cloud but you can change it to something such as yourdomain.freedns.com, allowing you to access HomeDock OS via a consistent hostname.

It will be deprecated in the future as we transition to a more advanced system for this feature, which includes our own free Dynamic DNS service. This service is expected to be released in Q4 2025 and will be available only for self-hosted environments, as Cloud Instances already include their own DNS service.

External Storage

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

Theme Settings

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 different wallpaper images, in future versions we will allow you to upload your own wallpapers for a personalized touch.

Choose your preferred theme by selecting the corresponding button and, if using Aero+, make sure you select your preferred wallpaper.

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 and old Docker images when updates are applied, ensuring efficient use of storage.
• Delete Old Data on App Uninstall: Removes all residual data and old Docker images 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.