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

@@ -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",

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

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>

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

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)
-

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.