Product: Mingcedar Share SHARE

Windows / macOS desktop and Linux systemd | Mingcedar Share

See Downloads for packages, platforms, and version notes. The shared file list serves only the selected host folder.

Published 2026-10-25T12:48:42.644690357Z Updated 2026-10-25T12:48:42.644689586Z

<div class="manual-doc-article manual-doc-article-section"><h2 id="service-mode">Service: Windows / macOS desktop and Linux systemd</h2>

Use desktop mode on Windows or macOS. Launch at login opens the desktop app without starting sharing automatically. The Linux installer enables and starts a systemd service with fixed settings and a dedicated account.

<h3 id="service-mode-item-1">Installer access</h3>

<p>See Downloads for packages, platforms, and version notes. The shared file list serves only the selected host folder.</p>

</article>

<h3 id="service-mode-item-2">macOS installation and operation</h3>

<p>The desktop package requires macOS 13 or later. Open the DMG and drag Mingcedar Share.app into Applications. Allow local-network and folder access when prompted. Restore the window from the menu bar; Command-Q stops sharing and exits. Check Downloads for available package architectures and access methods.</p>

</article>

<h3 id="service-mode-item-3">macOS launch at login and configuration</h3>

<p>Launch at login uses a per-user LaunchAgent to open the desktop app without automatically starting sharing. Install in Applications first; disable login startup before moving or removing the app. New settings use <code>~/Library/Application Support/HQ VISU/HQShare/config.json</code>; an existing <code>~/.hqvisu/hqshare/config.json</code> remains in use.</p>

</article>

<h3 id="service-mode-item-4">macOS opening notice</h3>

<p>The package is not notarized by Apple. If macOS blocks it, verify its source and follow the system Privacy & Security guidance.</p>

</article>

<h3 id="service-mode-item-5">Linux environment versus runtime configuration</h3>

<p><code>/etc/hqshare/hqshare.env</code> points to the executable and configuration file. The shared folder, port, bind address, and users are stored in <code>config.json</code>. Restart the service after CLI configuration changes.</p>

</article>

<h3 id="service-mode-item-6">Windows Explorer and headless mode</h3>

<p>Windows can add a per-user Explorer menu. Share this folder automatically starts sharing with the saved port and bind address. Configure accounts, change the initial password, and check network scope before first use. For headless Linux, use the systemd package.</p>

</article>

<h3 id="service-mode-item-7">Windows desktop mode</h3>

<p>The Windows desktop app configures the shared folder, port, and bind address. Settings are stored under the current user.</p>

</article>

<h3 id="service-mode-item-8">Windows tray and current-user startup</h3>

<p>Desktop mode can continue running from the system tray after the window closes and can enable startup for the current Windows user. Confirm the shared folder, port, and allowed network segment before use.</p>

</article>

<h3 id="service-mode-item-9">Linux service configuration file</h3>

<p>Linux systemd reads <code>/etc/hqshare/config.json</code>. Share path, port, bind address, upload limit, users, and password hashes are stored there.</p>

</article>

<h3 id="service-mode-item-10">Linux startup on boot</h3>

<p>Enable or disable hqshare startup through systemd; configuration, shared files, and accounts are retained.</p>

<div class="manual-code" data-code-language="text"><div class="manual-code-toolbar"><span>Text</span><span class="manual-code-tools"><small>Text</small><button type="button" data-copy-code data-copied="Copied" data-failed="Select and copy the code" aria-label="Copy code: Text">Copy code</button><span class="manual-code-status" role="status"></span></span></div><pre tabindex="0" class="docs-code-block shiki github-light" style="background-color:#fff;color:#24292e" tabindex="0"><code><span class="line"><span># Linux: enable startup on boot</span></span>

<span class="line"><span>sudo systemctl enable hqshare</span></span>

<span class="line"><span># Linux: disable startup on boot</span></span>

<span class="line"><span>sudo systemctl disable hqshare</span></span>

<span class="line"><span># Linux: check startup state</span></span>

<span class="line"><span>sudo systemctl is-enabled hqshare</span></span></code></pre></div>

</article>

<h3 id="service-mode-item-11">Linux systemd</h3>

<p>Install from the Linux service package. The installer runs under the dedicated <code>hqshare</code> user. Initially bind only to localhost, change the initial manager password through the CLI, then configure the actual LAN IP shown below.</p>

<span class="line"><span>cd HQShare-Linux-Service</span></span>

<span class="line"><span>sudo ./install-linux-service.sh --share-path /srv/hqshare/public --port 5995 --bind 127.0.0.1</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user reset-password admin --password '<set-a-unique-password>'</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json config set \</span></span>

<span class="line"><span> --share-path /srv/hqshare/public \</span></span>

<span class="line"><span> --max-upload-mb 1024</span></span>

<span class="line"><span>sudo systemctl restart hqshare</span></span></code></pre></div>

</article>

<h3 id="service-mode-item-12">Linux service status and logs</h3>

<p>After installation, check the systemd unit, environment file, and runtime config. Restart after configuration changes and use the journal to confirm the bind address, port, and shared folder.</p>

<span class="line"><span>sudo journalctl -u hqshare -f</span></span>

<span class="line"><span>sudo cat /etc/hqshare/hqshare.env</span></span>

<span class="line"><span>sudo cat /etc/hqshare/config.json</span></span>

<span class="line"><span>sudo systemctl restart hqshare</span></span>

<span class="line"><span>sudo systemctl stop hqshare</span></span>

<span class="line"><span>sudo systemctl start hqshare</span></span></code></pre></div>

</article>

<h3 id="service-mode-item-13">User management</h3>

<p>Linux service mode manages accounts through the command line. Replace the example passwords below with unique passwords for your deployment. Use <code>viewer</code>, <code>operator</code>, or <code>manager</code> roles. After CLI account, password, or role changes, restart the running service to load the saved configuration and clear existing sessions.</p>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user add operator01 --password '<set-a-unique-password>' --role operator --display-name 'Field Operator'</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user update operator01 --role viewer</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user reset-password operator01 --password '<set-a-new-password>'</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user update operator01 --disable</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user update operator01 --enable</span></span>

<span class="line"><span>sudo -u hqshare /opt/hqshare/HQShare --config /etc/hqshare/config.json user delete operator01</span></span>

<span class="line"><span>sudo systemctl restart hqshare</span></span></code></pre></div>

</article>

<h3 id="service-mode-item-14">Occupied port handling</h3>

<p>If the port is occupied, the desktop app suggests another. For service mode, change the port configuration and restart.</p>

</article>

<h3 id="service-mode-item-15">Bind address</h3>

<p><code>0.0.0.0</code> listens on all IPv4 interfaces; a specific IP listens only there; <code>127.0.0.1</code> is local-only. Displayed URLs are candidates and may not all work. Test the actual bound address and port, and restrict sources through the firewall.</p>

</article>

</div>

<strong>Figure 1: macOS desktop operation</strong>

<p>macOS interface in Chinese: configure the shared folder and access address, then view the service state.</p>

</figcaption>

</figure>

</div>