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

New Issue

GiteaMirror · 2026-05-06T15:15:57-05:00

GiteaMirror commented

2026-05-06 15:15:57 -05:00

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

GiteaMirror closed this issue

2026-05-06 15:15:58 -05:00

GiteaMirror commented

2026-05-06 15:16:03 -05:00

@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?

@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?

GiteaMirror commented

2026-05-06 15:16:07 -05:00

@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

@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

GiteaMirror commented

2026-05-06 15:16:09 -05:00

@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.

@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.

GiteaMirror commented

2026-05-06 15:16:12 -05:00

@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.

@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.

GiteaMirror commented

2026-05-06 15:16:15 -05:00

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

Glad its fixed! :}

@oschwartz10612 commented on GitHub (Dec 18, 2025): Glad its fixed! :}

GiteaMirror commented

2026-05-06 15:16:19 -05:00

@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.

@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.

GiteaMirror commented

2026-05-06 15:16:26 -05:00

@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.

@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#10828