Skip to content
HaruHostGSM Docs

Install As a Service

Use this guide to install the HaruHost CLI as a background service so it starts automatically and stays available for remote access. The CLI app keeps the full HaruHost feature set, with the main graphical UI handled through the web panel.

Before You Start

Section titled “Before You Start”
  • Use the CLI app, not the Desktop Application, when you want service mode.
  • The CLI app keeps the same HaruHost features as the Desktop Application and adds service support.
  • Complete the initial HaruHost setup first.
  • Service installation needs administrative permissions.
  • This setup is especially useful for machines that mainly host game servers.

Windows

Section titled “Windows”

Start the CLI app

Section titled “Start the CLI app”
  1. Download the Windows CLI build from Downloads.
  2. Launch haruhost-cli.exe.
  3. Finish the initial setup in the terminal. After setup, the main graphical UI is managed through the web panel.

Install the service

Section titled “Install the service”
  1. In the CLI terminal, run service install.
  2. If HaruHost reports that administrative permissions are required, reopen haruhost-cli.exe as Administrator.
  3. Run service install again.
  4. Wait for HaruHost to report that the service was installed and started.

The same service install flow is also available in Settings → Launch Settings as Install As Service.

What you get

Section titled “What you get”
  • Same HaruHost management features, with the main graphical UI available through the web panel.
  • HaruHost starts automatically while the PC is running.
  • The background runtime stays available through the web panel.
  • Reopen App is available for the connected service runtime.
  • Restart Computer is available from remote sessions connected to the service runtime.

Linux

Section titled “Linux”

Install the service

Section titled “Install the service”
  1. Download the Linux CLI build from Downloads.
  2. If you are using the raw downloaded binary, run sudo ./haruhost-cli install.
  3. Wait for HaruHost to report that the service was installed and started.

HaruHost installs the Linux service runtime under /opt/haruhost, stores application data under /var/lib/haruhost, and creates the command path at /usr/local/bin/haruhost.

What you get

Section titled “What you get”
  • Same HaruHost management features, with the main graphical UI available through the web panel.
  • HaruHost starts automatically when the machine boots.
  • The service keeps HaruHost available for remote management.
  • You can manage the machine without needing to stay at the computer.

Remove the service later

Section titled “Remove the service later”

If you want to remove the service from the CLI later, run service uninstall.