From ba898cd9f8c233126455b7ec83886c92998e22c3 Mon Sep 17 00:00:00 2001 From: AnonymousGCA <39743848+GABRYCA@users.noreply.github.com> Date: Tue, 24 Dec 2024 13:50:18 +0100 Subject: [PATCH 1/4] Create CoolifyAndTraefikProxy --- community/CoolifyAndTraefikProxy | 73 ++++++++++++++++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 community/CoolifyAndTraefikProxy diff --git a/community/CoolifyAndTraefikProxy b/community/CoolifyAndTraefikProxy new file mode 100644 index 0000000..59829d5 --- /dev/null +++ b/community/CoolifyAndTraefikProxy @@ -0,0 +1,73 @@ +--- +layout: page +title: Reverse-Proxy on Coolify with Traefik +parent: Community Guides +nav_order: 9 +--- + +# Reverse proxy BlueMap with Traefik + +Here are some examples how you can use Coolify + Traefik (Installed by default on Coolify) to reverse-proxy your BlueMap. + +This is useful if you want to integrate your map in your website and you're using Coolify, or want to add SSL-capabilities. + +## Assumptions / Prerequisites +- You have access to Coolify's dashboard (:8000). +- You already have a daemon server installed on Coolify (:8000/servers). +- BlueMaps integrated webserver is running on port `8100` and accessible on :8100. *(If that is not the case you'll need to replace `8100` with the actual port below)* + +> **Warning:**
+> Telling the internal-webserver to only connect to one specific address like e.g. `127.0.0.1`, +> on your `webserver.conf` by adding `ip: "127.0.0.1"` setting somewhere WILL GIVE A *BAD GATEWAY* ERROR. +{: .warning } + +## BlueMap on a subdomain +Go to Coolify's Dashboard -> Servers -> -> Proxy -> Dynamic Configurations +Press "+ Add", give it a name like e.g. `bluemap.yaml` and make something like this: +For BlueMap on a subdomain e.g. `https://bluemap.example.com` (replace public_address with your public IP): +```yaml +http: + routers: + bluemap: + entryPoints: + - "websecure" + rule: "Host(`www.example.com`) && PathPrefix(`/bluemap/`)" + service: "bluemap" + tls: + certResolver: letsencrypt + services: + bluemap: + loadBalancer: + servers: + - url: "http://public_address:8100" +``` +Press `Save` and `Reload`. + + +## BlueMap on a subdirectory of your website +Go to Coolify's Dashboard -> Servers -> -> Proxy -> Dynamic Configurations +Press "+ Add", give it a name like e.g. `bluemap.yaml` and make something like this: +For BlueMap on a subdirectory e.g `https://www.example.com/bluemap` (replace public_address with your public IP): +```yaml +http: + routers: + bluemap: + entryPoints: + - "websecure" + rule: "Host(`www.example.com`) && PathPrefix(`/bluemap/`)" + service: "bluemap" + tls: + certResolver: letsencrypt + middlewares: + - "bluemapprefix" + services: + bluemap: + loadBalancer: + servers: + - url: "http://public_address:8100" + middlewares: + bluemapprefix: + stripprefix: + prefixes: "/bluemap/" +``` +Press `Save` and `Reload`. From 0f25ea7b9050539c31a015b55d92ac07c7486061 Mon Sep 17 00:00:00 2001 From: AnonymousGCA <39743848+GABRYCA@users.noreply.github.com> Date: Tue, 24 Dec 2024 15:06:48 +0100 Subject: [PATCH 2/4] Rename CoolifyAndTraefikProxy to CoolifyAndTraefikProxy.md --- community/{CoolifyAndTraefikProxy => CoolifyAndTraefikProxy.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename community/{CoolifyAndTraefikProxy => CoolifyAndTraefikProxy.md} (100%) diff --git a/community/CoolifyAndTraefikProxy b/community/CoolifyAndTraefikProxy.md similarity index 100% rename from community/CoolifyAndTraefikProxy rename to community/CoolifyAndTraefikProxy.md From 08467c77ec2e6130ffab1871ff890a5e6645937d Mon Sep 17 00:00:00 2001 From: GABRYCA <39743848+GABRYCA@users.noreply.github.com> Date: Tue, 24 Dec 2024 15:37:35 +0100 Subject: [PATCH 3/4] Updated nav_order on Community Guides. --- community/CloudflareR2.md | 2 +- community/OCIConfiguration.md | 2 +- community/Translating.md | 2 +- community/WorldBorder.md | 2 +- community/python-screenshots.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/community/CloudflareR2.md b/community/CloudflareR2.md index bb197d2..d3a2e18 100644 --- a/community/CloudflareR2.md +++ b/community/CloudflareR2.md @@ -2,7 +2,7 @@ layout: page title: Hosting BlueMap on Cloudflare R2 parent: Community Guides -nav_order: 15 +nav_order: 16 --- # How to host BlueMap on Cloudflare R2 diff --git a/community/OCIConfiguration.md b/community/OCIConfiguration.md index 985a91b..02cd22a 100644 --- a/community/OCIConfiguration.md +++ b/community/OCIConfiguration.md @@ -2,7 +2,7 @@ layout: page title: Oracle Cloud Instance - Ports opening (Oracle Linux and Ubuntu) parent: Community Guides -nav_order: 9 +nav_order: 11 --- # Oracle Cloud Instance - Ports opening (Oracle Linux and Ubuntu) diff --git a/community/Translating.md b/community/Translating.md index 12c991e..1fe31ea 100644 --- a/community/Translating.md +++ b/community/Translating.md @@ -2,7 +2,7 @@ layout: page title: Translating BlueMap parent: Community Guides -nav_order: 13 +nav_order: 15 --- # Translating BlueMap diff --git a/community/WorldBorder.md b/community/WorldBorder.md index be94800..0f5faf1 100644 --- a/community/WorldBorder.md +++ b/community/WorldBorder.md @@ -2,7 +2,7 @@ layout: page title: Adding a World Border parent: Community Guides -nav_order: 12 +nav_order: 13 --- # Adding a World Border diff --git a/community/python-screenshots.md b/community/python-screenshots.md index 4f54418..a6fb631 100644 --- a/community/python-screenshots.md +++ b/community/python-screenshots.md @@ -2,7 +2,7 @@ layout: page title: Render screenshots from Python parent: Community Guides -nav_order: 11 +nav_order: 12 --- # Render screenshots from Python From 4175621c59c8640d95952332a73b83fd1d6f9e19 Mon Sep 17 00:00:00 2001 From: GABRYCA <39743848+GABRYCA@users.noreply.github.com> Date: Tue, 24 Dec 2024 20:29:53 +0100 Subject: [PATCH 4/4] Improved CoolifyAndTraefikProxy.md docs. --- community/CoolifyAndTraefikProxy.md | 48 +++++++++++++++++------------ 1 file changed, 28 insertions(+), 20 deletions(-) diff --git a/community/CoolifyAndTraefikProxy.md b/community/CoolifyAndTraefikProxy.md index 59829d5..ddf9116 100644 --- a/community/CoolifyAndTraefikProxy.md +++ b/community/CoolifyAndTraefikProxy.md @@ -5,55 +5,59 @@ parent: Community Guides nav_order: 9 --- -# Reverse proxy BlueMap with Traefik +# Reverse proxy BlueMap on Coolify with Traefik -Here are some examples how you can use Coolify + Traefik (Installed by default on Coolify) to reverse-proxy your BlueMap. +Here are some examples of how you can use Coolify + Traefik (Installed by default on Coolify) to reverse-proxy your BlueMap. This is useful if you want to integrate your map in your website and you're using Coolify, or want to add SSL-capabilities. ## Assumptions / Prerequisites -- You have access to Coolify's dashboard (:8000). -- You already have a daemon server installed on Coolify (:8000/servers). -- BlueMaps integrated webserver is running on port `8100` and accessible on :8100. *(If that is not the case you'll need to replace `8100` with the actual port below)* +- You have already added an `A record` to your domain pointing to your `public IP`. +- If you're planning on using a `subdomain`, you have already added an `A record` with your subdomain e.g. `bluemap` to your domain pointing to your `public IP`. +- You have access to Coolify's dashboard (`public_address:8000`). +- You already have a daemon server installed on Coolify (`public_address:8000/servers`). +- BlueMaps integrated webserver is running on port `8100` and accessible on `public_address:8100` e.g. **if** your public_address is `200.121.121.100` then BlueMaps should be accessible from `200.121.121.100:8100`. *(If that is not the case you'll need to replace `8100` with the actual port below)* > **Warning:**
-> Telling the internal-webserver to only connect to one specific address like e.g. `127.0.0.1`, -> on your `webserver.conf` by adding `ip: "127.0.0.1"` setting somewhere WILL GIVE A *BAD GATEWAY* ERROR. -{: .warning } +> Telling the internal-webserver to connect to one specific address like e.g. `127.0.0.1`, +>
from `webserver.conf` by adding `ip: "127.0.0.1"` WILL GIVE A **BAD GATEWAY** ERROR. +{: .info } ## BlueMap on a subdomain -Go to Coolify's Dashboard -> Servers -> -> Proxy -> Dynamic Configurations -Press "+ Add", give it a name like e.g. `bluemap.yaml` and make something like this: -For BlueMap on a subdomain e.g. `https://bluemap.example.com` (replace public_address with your public IP): +- Go to `Coolify's Dashboard -> Servers -> YourServer -> Proxy -> Dynamic Configurations` +- Press `+ Add`, give it a name like e.g. `bluemap.yaml` and make something like this: + +BlueMap on a subdomain e.g. `https://bluemap.example.com` (replace `public_address` with your `public IP`): ```yaml http: routers: - bluemap: + map-router: + rule: Host(`bluemap.example.com`) entryPoints: - - "websecure" - rule: "Host(`www.example.com`) && PathPrefix(`/bluemap/`)" - service: "bluemap" + - https + service: bluemap tls: certResolver: letsencrypt services: bluemap: loadBalancer: servers: - - url: "http://public_address:8100" + - url: 'http://public_address:8100' ``` Press `Save` and `Reload`. ## BlueMap on a subdirectory of your website -Go to Coolify's Dashboard -> Servers -> -> Proxy -> Dynamic Configurations -Press "+ Add", give it a name like e.g. `bluemap.yaml` and make something like this: -For BlueMap on a subdirectory e.g `https://www.example.com/bluemap` (replace public_address with your public IP): +- Go to `Coolify's Dashboard -> Servers -> YourServer -> Proxy -> Dynamic Configurations`. +- Press `+ Add`, give it a name like e.g. `bluemap.yaml` and make something like this: + +BlueMap on a subdirectory e.g `https://www.example.com/bluemap` (replace `public_address` with your `public IP`): ```yaml http: routers: bluemap: entryPoints: - - "websecure" + - https rule: "Host(`www.example.com`) && PathPrefix(`/bluemap/`)" service: "bluemap" tls: @@ -71,3 +75,7 @@ http: prefixes: "/bluemap/" ``` Press `Save` and `Reload`. + +> **Warning:**
+> If you're using CloudFlare, make sure to add to your DNS an A record with your subdomain e.g. `bluemap` pointing to your public IP. +{: .info } \ No newline at end of file