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
@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?
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
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.
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.
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.
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.
I'm also having this issue. None of these fixes work for me. Also this seemingly doesn't exist:
General > Login Items & Extension > By Category > Network Extensions
I've also tried deleting the application, removing the extensions and VPN config, and reinstalling everything. Still stuck on "registering".
<!-- gh-comment-id:4472323141 -->
@kylepyke commented on GitHub (May 17, 2026):
I'm also having this issue. None of these fixes work for me. Also this seemingly doesn't exist:
>General > Login Items & Extension > By Category > Network Extensions
I've also tried deleting the application, removing the extensions and VPN config, and reinstalling everything. Still stuck on "registering".
I am having this exact same issue as well. MacOS 15.7.7 and Pangolin Client on the latest version (including doing a fresh install of the client)
Pangolin server is deployed on a VPS via Docker. Pangolin and Gerbil containers are at the latest versions (compose file used :latest).
Error in Pangolin container logs:
"2026-05-25T05:31:15+00:00 [warn]: [handleOlmRegisterMessage] Client last hole punch is too old and we have sites to send; skipping this register. The client is failing to hole punch and identify its network address with the server. Can the client reach the server on UDP port 21820?"
On client machine, I can connect to UDP port 21820 via nc (nc -zvu <pang server> 21820) [Tested both hostname and IP address]
<!-- gh-comment-id:4531846039 -->
@deja-geek commented on GitHub (May 25, 2026):
I am having this exact same issue as well. MacOS 15.7.7 and Pangolin Client on the latest version (including doing a fresh install of the client)
Pangolin server is deployed on a VPS via Docker. Pangolin and Gerbil containers are at the latest versions (compose file used :latest).
Error in Pangolin container logs:
> "2026-05-25T05:31:15+00:00 [warn]: [handleOlmRegisterMessage] Client last hole punch is too old and we have sites to send; skipping this register. The client is failing to hole punch and identify its network address with the server. Can the client reach the server on UDP port 21820?"
On client machine, I can connect to UDP port 21820 via nc (`nc -zvu <pang server> 21820`) [Tested both hostname and IP address]
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
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
To Reproduce
Install client on macOS and register it via web browser
Expected Behavior
It should connect and let me use my private resources
@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?
@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
@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.
@TehMaat commented on GitHub (Dec 17, 2025):
Thanks, that was the issue. It might have been fast enough hahaha.
@oschwartz10612 commented on GitHub (Dec 18, 2025):
Glad its fixed! :}
@soakes commented on GitHub (Jan 4, 2026):
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.
@cku-heise commented on GitHub (Feb 13, 2026):
In addition to the VPN profile, make sure that the log-on item is enabled:
For some reason, this was not toggled on in my setup, even though the VPN profile existed.
@kylepyke commented on GitHub (May 17, 2026):
I'm also having this issue. None of these fixes work for me. Also this seemingly doesn't exist:
I've also tried deleting the application, removing the extensions and VPN config, and reinstalling everything. Still stuck on "registering".
@deja-geek commented on GitHub (May 25, 2026):
I am having this exact same issue as well. MacOS 15.7.7 and Pangolin Client on the latest version (including doing a fresh install of the client)
Pangolin server is deployed on a VPS via Docker. Pangolin and Gerbil containers are at the latest versions (compose file used :latest).
Error in Pangolin container logs:
On client machine, I can connect to UDP port 21820 via nc (
nc -zvu <pang server> 21820) [Tested both hostname and IP address]