Health file not available #20

Closed
opened 2025-11-19 07:04:17 -06:00 by GiteaMirror · 0 comments
Owner

Originally created by @Skillkiller on GitHub (Oct 18, 2025).

Describe the Bug

Hello,
I tried to check the status of my client connection using the health file. The documentation states that the client creates a file when the connection is OK.

Docs: https://docs.pangolin.net/manage/clients/configure-client#param-olm-health-file
Archived version: https://web.archive.org/web/20251018231308/https://docs.pangolin.net/manage/clients/configure-client#param-olm-health-file

I first tried using the ENVs, but this file was not created as expected. I then tried the argument --health-file and received the following error message:

flag provided but not defined: -health-file
Usage of service:
  -dns string
        DNS server to use (default "8.8.8.8")
  -enable-http
        Enable HTT server for receiving connection requests
  -holepunch
        Enable hole punching (default false)
  -http-addr string
        HTTP server address (e.g., ':9452') (default ":9452")
  -interface string
        Name of the WireGuard interface (default "olm")
  -log-level string
        Log level (DEBUG, INFO, WARN, ERROR, FATAL) (default "INFO")
  -mtu string
        MTU to use (default "1280")
  -ping-interval string
        Interval for pinging the server (default 3s) (default "3s")
  -ping-timeout string
                Timeout for each ping (default 3s) (default "5s")
  -version
        Print the version
Error parsing service arguments: flag provided but not defined: -health-file

It looks like this function is not implemented in the Olm client. The arguments and Envs should be removed from the documentation or the functionality should be added to the client. The documentation in its current state is misleading.

Environment

  • OS Type & Version: Debian 13 Arm64
  • Pangolin Version:
  • Gerbil Version:
  • Traefik Version:
  • Newt Version:
  • Olm Version: Olm version 1.1.4

To Reproduce

  1. Download Olm version 1.1.4
  2. Run ./olm --health-file /tmp/olm-status
  3. See printed error

Expected Behavior

The file should be created and removed according to the documentation.

Originally created by @Skillkiller on GitHub (Oct 18, 2025). ### Describe the Bug Hello, I tried to check the status of my client connection using the health file. The documentation states that the client creates a file when the connection is OK. Docs: https://docs.pangolin.net/manage/clients/configure-client#param-olm-health-file Archived version: https://web.archive.org/web/20251018231308/https://docs.pangolin.net/manage/clients/configure-client#param-olm-health-file I first tried using the ENVs, but this file was not created as expected. I then tried the argument ``--health-file`` and received the following error message: ``` flag provided but not defined: -health-file Usage of service: -dns string DNS server to use (default "8.8.8.8") -enable-http Enable HTT server for receiving connection requests -holepunch Enable hole punching (default false) -http-addr string HTTP server address (e.g., ':9452') (default ":9452") -interface string Name of the WireGuard interface (default "olm") -log-level string Log level (DEBUG, INFO, WARN, ERROR, FATAL) (default "INFO") -mtu string MTU to use (default "1280") -ping-interval string Interval for pinging the server (default 3s) (default "3s") -ping-timeout string Timeout for each ping (default 3s) (default "5s") -version Print the version Error parsing service arguments: flag provided but not defined: -health-file ``` It looks like this function is not implemented in the Olm client. The arguments and Envs should be removed from the documentation or the functionality should be added to the client. The documentation in its current state is misleading. ### Environment - OS Type & Version: Debian 13 Arm64 - Pangolin Version: - Gerbil Version: - Traefik Version: - Newt Version: - Olm Version: Olm version 1.1.4 ### To Reproduce 1. Download Olm version 1.1.4 2. Run ``./olm --health-file /tmp/olm-status`` 3. See printed error ### Expected Behavior The file should be created and removed according to the documentation.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/olm#20