[GH-ISSUE #2091] Pangolin Client on Macos With GUI stuck on Registering #6863

Closed
opened 2026-04-25 15:48:59 -05:00 by GiteaMirror · 7 comments
Owner

Originally created by @TehMaat on GitHub (Dec 16, 2025).
Original GitHub issue: https://github.com/fosrl/pangolin/issues/2091

Describe the Bug

I installed the Pangolin Client on the website, but it's not working. I registered via browser and eevyrighitn look synced but the app on macOS is stuck on registering

Environment

  • OS Type & Version: MacOS 26.1
  • Pangolin Version: 1.13.0
  • Gerbil Version:
  • Traefik Version: 3.4
  • Newt Version: 1.7
  • Olm Version: 0.1.2

To Reproduce

Install client on macOS and register it via web browser

Expected Behavior

It should connect and let me use my private resources

Originally created by @TehMaat on GitHub (Dec 16, 2025). Original GitHub issue: https://github.com/fosrl/pangolin/issues/2091 ### Describe the Bug I installed the Pangolin Client on the website, but it's not working. I registered via browser and eevyrighitn look synced but the app on macOS is stuck on registering ### Environment - OS Type & Version: MacOS 26.1 - Pangolin Version: 1.13.0 - Gerbil Version: - Traefik Version: 3.4 - Newt Version: 1.7 - Olm Version: 0.1.2 ### To Reproduce Install client on macOS and register it via web browser ### Expected Behavior It should connect and let me use my private resources
Author
Owner

@oschwartz10612 commented on GitHub (Dec 16, 2025):

Hi! Could you double check the pangolin logs and see if there are any
warnings? This could be related to UDP port 21820 not being open on your
pangolin server. Could you also verify that?

<!-- gh-comment-id:3661200702 --> @oschwartz10612 commented on GitHub (Dec 16, 2025): Hi! Could you double check the pangolin logs and see if there are any warnings? This could be related to UDP port 21820 not being open on your pangolin server. Could you also verify that?
Author
Owner

@TehMaat commented on GitHub (Dec 16, 2025):

I get nothing from pangolin logs and nothing on port 21820 while using the new GUI, while using the old cli command i get packets on port 21280

<!-- gh-comment-id:3662191144 --> @TehMaat commented on GitHub (Dec 16, 2025): I get nothing from pangolin logs and nothing on port 21820 while using the new GUI, while using the old cli command i get packets on port 21280
Author
Owner

@jiriteach commented on GitHub (Dec 16, 2025):

I had this issue - need to make sure that the VPN profile is installed. The app does prompt on initial setup but its quickly gone and often missed. Enable the extension and permission to allow for this.

<!-- gh-comment-id:3662266318 --> @jiriteach commented on GitHub (Dec 16, 2025): I had this issue - need to make sure that the VPN profile is installed. The app does prompt on initial setup but its quickly gone and often missed. Enable the extension and permission to allow for this.
Author
Owner

@TehMaat commented on GitHub (Dec 17, 2025):

I had this issue - need to make sure that the VPN profile is installed. The app does prompt on initial setup but its quickly gone and often missed. Enable the extension and permission to allow for this.

Thanks, that was the issue. It might have been fast enough hahaha.

<!-- gh-comment-id:3664180909 --> @TehMaat commented on GitHub (Dec 17, 2025): > I had this issue - need to make sure that the VPN profile is installed. The app does prompt on initial setup but its quickly gone and often missed. Enable the extension and permission to allow for this. Thanks, that was the issue. It might have been fast enough hahaha.
Author
Owner

@oschwartz10612 commented on GitHub (Dec 18, 2025):

Glad its fixed! :}

<!-- gh-comment-id:3670886420 --> @oschwartz10612 commented on GitHub (Dec 18, 2025): Glad its fixed! :}
Author
Owner

@soakes commented on GitHub (Jan 4, 2026):

I had this issue - need to make sure that the VPN profile is installed. The app does prompt on initial setup but its quickly gone and often missed. Enable the extension and permission to allow for this.

Thousand thank yous. Just wasted the past couple of hours trying to debug my new instance and now just found this issue. Doh, should of googled sooner :) Thanks again.

<!-- gh-comment-id:3707497612 --> @soakes commented on GitHub (Jan 4, 2026): > I had this issue - need to make sure that the VPN profile is installed. The app does prompt on initial setup but its quickly gone and often missed. Enable the extension and permission to allow for this. Thousand thank yous. Just wasted the past couple of hours trying to debug my new instance and now just found this issue. Doh, should of googled sooner :) Thanks again.
Author
Owner

@cku-heise commented on GitHub (Feb 13, 2026):

In addition to the VPN profile, make sure that the log-on item is enabled:

  • As per the documentation: In System Settings, under General > Login Items & Extension > By Category > Network Extensions, ensure that Pangolin.app is toggled on.

For some reason, this was not toggled on in my setup, even though the VPN profile existed.

<!-- gh-comment-id:3895374291 --> @cku-heise commented on GitHub (Feb 13, 2026): In addition to the VPN profile, make sure that the log-on item is enabled: * As [per the documentation](https://docs.pangolin.net/manage/clients/install-client#installation-steps-2): In System Settings, under General > Login Items & Extension > By Category > Network Extensions, ensure that Pangolin.app is toggled on. For some reason, this was not toggled on in my setup, even though the VPN profile existed.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/pangolin#6863