From 1a30c76513521227db80988a2a358072bf980802 Mon Sep 17 00:00:00 2001
From: Laurence <laurence.jones@live.co.uk>
Date: Fri, 6 Feb 2026 12:55:15 +0000
Subject: [PATCH 1/2] enhance(geoblock): Warning for legacy method

fix: #49
This PR adds a warning to the top of the Native GeoBlock article to a new dedicated community guide how to remove the legacy method of geoblocking
---
 docs.json                                     |  1 +
 manage/geoblocking.mdx                        |  5 +-
 self-host/advanced/enable-geoblocking.mdx     |  4 ++
 self-host/community-guides/geoblock.mdx       |  4 ++
 self-host/community-guides/overview.mdx       |  5 +-
 .../remove-geoblock-plugin.mdx                | 62 +++++++++++++++++++
 6 files changed, 79 insertions(+), 2 deletions(-)
 create mode 100644 self-host/community-guides/remove-geoblock-plugin.mdx

diff --git a/docs.json b/docs.json
index 2875015..41a213a 100644
--- a/docs.json
+++ b/docs.json
@@ -172,6 +172,7 @@
                                 "group": "Community Guides",
                                 "pages": [
                                     "self-host/community-guides/overview",
+                                    "self-host/community-guides/remove-geoblock-plugin",
                                     "self-host/community-guides/crowdsec",
                                     "self-host/community-guides/metrics",
                                     "self-host/community-guides/homeassistant",
diff --git a/manage/geoblocking.mdx b/manage/geoblocking.mdx
index f060097..cc6ad37 100644
--- a/manage/geoblocking.mdx
+++ b/manage/geoblocking.mdx
@@ -7,6 +7,10 @@ description: "Configure geo blocking to restrict access based on geographic loca
 Geoblocking is available in Pangolin community! Make sure to follow this guide for how to enable: [Enabling Geo Blocking](/self-host/advanced/enable-geoblocking)
 </Note>
 
+<Warning>
+If you previously enabled the Traefik GeoBlock plugin (PascalMinder), remove that plugin and its middleware config before using native geoblocking in Pangolin. See [Remove the GeoBlock plugin](/self-host/community-guides/remove-geoblock-plugin).
+</Warning>
+
 <iframe
   className="w-full aspect-video rounded-xl"
   src="https://www.youtube.com/embed/_2EheKVUYxI"
@@ -88,4 +92,3 @@ Priority 4: Deny - Country: ALL
 ```
 
 This configuration allows access only from the US, Canada, and UK while blocking all other countries.
-
diff --git a/self-host/advanced/enable-geoblocking.mdx b/self-host/advanced/enable-geoblocking.mdx
index 87452e1..6838860 100644
--- a/self-host/advanced/enable-geoblocking.mdx
+++ b/self-host/advanced/enable-geoblocking.mdx
@@ -3,6 +3,10 @@ title: "Enable Geo-blocking"
 description: "Configuration requirements to enable geoblocking in Pangolin"
 ---
 
+<Warning>
+If you previously enabled the Traefik GeoBlock plugin (PascalMinder), remove that plugin and its middleware config before enabling native geoblocking in Pangolin. Running both can cause unexpected blocks or startup errors. See [Remove the GeoBlock plugin](/self-host/community-guides/remove-geoblock-plugin).
+</Warning>
+
 To enable geoblocking in Pangolin Community you must download and place the Maxmind geoip database into the `config/` directory and update the config file. This can be done for free.
 
 <Tip>
diff --git a/self-host/community-guides/geoblock.mdx b/self-host/community-guides/geoblock.mdx
index e4f222c..9ac5bb4 100644
--- a/self-host/community-guides/geoblock.mdx
+++ b/self-host/community-guides/geoblock.mdx
@@ -6,6 +6,10 @@ title: "GeoBlock"
 This is a community guide and is not officially supported. If you have any issues, please reach out to the [author](https://github.com/Lokowitz).
 </Note>
 
+<Warning>
+Legacy guide. Pangolin now supports native geoblocking. If you previously installed this plugin, follow [Remove GeoBlock Plugin](/self-host/community-guides/remove-geoblock-plugin) before enabling native geoblocking.
+</Warning>
+
 GeoBlock is a Traefik middleware that uses IP-based geolocation to allow or block traffic from specific countries. It helps enhance security and access control by restricting unwanted or potentially harmful connections based on geographic regions.
 
 ## Installation
diff --git a/self-host/community-guides/overview.mdx b/self-host/community-guides/overview.mdx
index 9403e17..5b06363 100644
--- a/self-host/community-guides/overview.mdx
+++ b/self-host/community-guides/overview.mdx
@@ -28,6 +28,10 @@ For additional information, consult the following resources:
 
 The GeoBlock plugin for Traefik is a middleware that restricts access based on the client’s geographic location. It runs within a Traefik container and uses IP-based geolocation to allow or block traffic from specific countries. This is useful for security, compliance, or access control in Traefik-managed services.
 
+<Note>
+Pangolin now supports native geoblocking. The GeoBlock plugin is considered legacy in Pangolin setups. If you previously installed it, follow [Remove GeoBlock Plugin](/self-host/community-guides/remove-geoblock-plugin) before enabling native geoblocking.
+</Note>
+
 For more details, please refer to the following resources:
 
 - [Github Repository](https://github.com/PascalMinder/geoblock)
@@ -69,4 +73,3 @@ The Traefik Logs Dashboard is a real-time dashboard for analyzing Traefik logs w
 For more details, please refer to the following resources:
 
 - [Github Repository](https://github.com/hhftechnology/traefik-log-dashboard)
-
diff --git a/self-host/community-guides/remove-geoblock-plugin.mdx b/self-host/community-guides/remove-geoblock-plugin.mdx
new file mode 100644
index 0000000..42aa927
--- /dev/null
+++ b/self-host/community-guides/remove-geoblock-plugin.mdx
@@ -0,0 +1,62 @@
+---
+title: "Remove GeoBlock Plugin"
+---
+
+<Note>
+This is a community guide and is not officially supported. If you have any issues, please reach out to the community on [Discord](https://pangolin.net/discord) or [Github discussions](https://github.com/orgs/fosrl/discussions).
+</Note>
+
+Pangolin now supports native geoblocking. If you previously installed the Traefik GeoBlock plugin, remove it before enabling native geoblocking to avoid duplicate blocking or startup errors.
+
+## Remove the GeoBlock plugin
+
+<Steps>
+<Step title="Remove GeoBlock middleware references">
+  Remove any references to `geoblock@file` from your Traefik entry points, routers, or labels.
+
+  Example removal in `/config/traefik/traefik_config.yml`:
+
+  ```yaml
+  entryPoints:
+    websecure:
+      http:
+        middlewares:
+          # Remove this line
+          - geoblock@file
+  ```
+</Step>
+<Step title="Remove the plugin definition from Traefik static config">
+  Delete the GeoBlock plugin block from `/config/traefik/traefik_config.yml`:
+
+  ```yaml
+  experimental:
+    plugins:
+      geoblock:
+        moduleName: github.com/PascalMinder/geoblock
+        version: v0.3.2
+  ```
+</Step>
+<Step title="Remove the middleware configuration from dynamic config">
+  Delete the GeoBlock middleware section from `/config/traefik/dynamic_config.yml`:
+
+  ```yaml
+  http:
+    middlewares:
+      geoblock:
+        plugin:
+          geoblock:
+            ...
+  ```
+</Step>
+<Step title="Restart Traefik">
+  Restart Traefik to apply the changes:
+
+  ```bash
+  docker restart traefik
+  ```
+</Step>
+</Steps>
+
+## Next steps
+
+Follow [Enable Geo-blocking](/self-host/advanced/enable-geoblocking) to configure native geoblocking in Pangolin.

From baeed507bc51495050be14af984798f11d7f0138 Mon Sep 17 00:00:00 2001
From: Laurence <laurence.jones@live.co.uk>
Date: Mon, 9 Feb 2026 10:15:30 +0000
Subject: [PATCH 2/2] docs(geoblock): focus legacy guidance on migration path

---
 manage/geoblocking.mdx                                | 4 ----
 self-host/advanced/enable-geoblocking.mdx             | 4 ----
 self-host/community-guides/remove-geoblock-plugin.mdx | 4 ++++
 3 files changed, 4 insertions(+), 8 deletions(-)

diff --git a/manage/geoblocking.mdx b/manage/geoblocking.mdx
index cc6ad37..7f85339 100644
--- a/manage/geoblocking.mdx
+++ b/manage/geoblocking.mdx
@@ -7,10 +7,6 @@ description: "Configure geo blocking to restrict access based on geographic loca
 Geoblocking is available in Pangolin community! Make sure to follow this guide for how to enable: [Enabling Geo Blocking](/self-host/advanced/enable-geoblocking)
 </Note>
 
-<Warning>
-If you previously enabled the Traefik GeoBlock plugin (PascalMinder), remove that plugin and its middleware config before using native geoblocking in Pangolin. See [Remove the GeoBlock plugin](/self-host/community-guides/remove-geoblock-plugin).
-</Warning>
-
 <iframe
   className="w-full aspect-video rounded-xl"
   src="https://www.youtube.com/embed/_2EheKVUYxI"
diff --git a/self-host/advanced/enable-geoblocking.mdx b/self-host/advanced/enable-geoblocking.mdx
index 6838860..87452e1 100644
--- a/self-host/advanced/enable-geoblocking.mdx
+++ b/self-host/advanced/enable-geoblocking.mdx
@@ -3,10 +3,6 @@ title: "Enable Geo-blocking"
 description: "Configuration requirements to enable geoblocking in Pangolin"
 ---
 
-<Warning>
-If you previously enabled the Traefik GeoBlock plugin (PascalMinder), remove that plugin and its middleware config before enabling native geoblocking in Pangolin. Running both can cause unexpected blocks or startup errors. See [Remove the GeoBlock plugin](/self-host/community-guides/remove-geoblock-plugin).
-</Warning>
-
 To enable geoblocking in Pangolin Community you must download and place the Maxmind geoip database into the `config/` directory and update the config file. This can be done for free.
 
 <Tip>
diff --git a/self-host/community-guides/remove-geoblock-plugin.mdx b/self-host/community-guides/remove-geoblock-plugin.mdx
index 42aa927..ca29b0e 100644
--- a/self-host/community-guides/remove-geoblock-plugin.mdx
+++ b/self-host/community-guides/remove-geoblock-plugin.mdx
@@ -8,6 +8,10 @@ This is a community guide and is not officially supported. If you have any issue
 
 Pangolin now supports native geoblocking. If you previously installed the Traefik GeoBlock plugin, remove it before enabling native geoblocking to avoid duplicate blocking or startup errors.
 
+<Note>
+After cleanup, follow [Enable Geo-blocking](/self-host/advanced/enable-geoblocking) to configure native geoblocking in Pangolin.
+</Note>
+
 ## Remove the GeoBlock plugin
 
 <Steps>