Skip to content

Community docs for Coolify + Traefik reverse proxy. #101

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Jan 5, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion community/CloudflareR2.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
81 changes: 81 additions & 0 deletions community/CoolifyAndTraefikProxy.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
---
layout: page
title: Reverse-Proxy on Coolify with Traefik
parent: Community Guides
nav_order: 9
---

# Reverse proxy BlueMap on Coolify with Traefik

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 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:**<br>
> Telling the internal-webserver to connect to one specific address like e.g. `127.0.0.1`,
> <br>from `webserver.conf` by adding `ip: "127.0.0.1"` WILL GIVE A **BAD GATEWAY** ERROR.
{: .info }
Comment on lines +21 to +24
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note: It won't give a bad gateway if you use the correct ip, but networking is hard, and it's probably the easiest to not change this, that's true :D


## BlueMap on a subdomain
- 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:
map-router:
rule: Host(`bluemap.example.com`)
entryPoints:
- https
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 -> 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:
- https
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`.

> **Warning:**<br>
> 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 }
2 changes: 1 addition & 1 deletion community/OCIConfiguration.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
2 changes: 1 addition & 1 deletion community/Translating.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
layout: page
title: Translating BlueMap
parent: Community Guides
nav_order: 13
nav_order: 15
---

# Translating BlueMap
Expand Down
2 changes: 1 addition & 1 deletion community/WorldBorder.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
layout: page
title: Adding a World Border
parent: Community Guides
nav_order: 12
nav_order: 13
---

# Adding a World Border
Expand Down
2 changes: 1 addition & 1 deletion community/python-screenshots.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
layout: page
title: Render screenshots from Python
parent: Community Guides
nav_order: 11
nav_order: 12
---

# Render screenshots from Python
Expand Down
Loading