Skip to main content
Gateway data is stored under the platform app data directory for hirogateway.

​
Default storage locations

  • Windows: %LOCALAPPDATA%\\hirogateway
  • macOS: ~/Library/Application Support/hirogateway
  • Linux: ~/.local/share/hirogateway

​
Directory structure

<app_data>/hirogateway/
  registry.json
  instances/
    <name>/
      config.json
      gateway.pid
      logs/

​
registry.json format

registry.json tracks all instances and the default instance. 
{
  "default_instance": "home",
  "instances": {
    "home": {
      "name": "home",
      "path": "C:/Users/<user>/AppData/Local/hirogateway/instances/home",
      "host": "0.0.0.0",
      "port": 8765
    }
  }
}

​
Fields

  • default_instance: instance name used when --instance is omitted
  • instances: map keyed by instance name
    • name: instance name
    • path: absolute path to instance folder
    • host: bind host
    • port: bind port

​
config.json format

Each instance has its own config.json. 
{
  "desktop_public_key": "<base64-ed25519-public-key>",
  "log_dir": ""
}

​
Fields

  • desktop_public_key: mandatory trust root configured at instance create
  • log_dir: optional persistent log directory override
    • empty string means default: <instance>/logs

​
gateway.pid

gateway.pid stores the active process ID for stop/status operations.
  • created on background start
  • removed on successful stop or when stale PID is detected

​
Logs

Logs are written to:
  • config.log_dir if configured
  • otherwise <instance>/logs
You can also pass hirogateway start --log-dir <path> for a runtime-only override.