White page when using baseurl-it-tools and Traefik

[j0hnby]

Describe the bug

Hi - thanks for the fork, very handy!

I have a stack set up for this - but it's not working - I still get a white screen

This is the compose I use

services:
  it-tools:
    container_name: it-tools
    image: ghcr.io/sharevb/it-tools:baseurl-it-tools
    restart: unless-stopped
    environment:
      - TZ=Europe/London
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.ittools.rule=Host(`site.mydomain.co.uk`) && PathPrefix(`/it-tools`)"
      - "traefik.http.routers.ittools.entrypoints=https"
      - "traefik.http.routers.ittools.tls=true"
      - "traefik.http.services.ittools.loadbalancer.server.port=8080"

    networks:
      - home-stack

networks:
  home-stack:
    external: true

This is what I get when I visit the site

Is there anything obvious I am doing wrong?

What happened?

When using baseurl-it-tools - I just get a white screen

System information

Docker / Traefik

Win 11 Edge

Where did you encounter the bug?

A self hosted

[Rumpick]

Have you tried the trailing / in the PathPrefix?

[j0hnby]

Hi @Rumpick - yes, as I had this as an issue when using Caddy or NGINX as a reverse proxy before - I have to navigate to the address with the extra trailing slash - but it has no affect on the issue - still a white page.

[lastplace1990]

I'm not a Traefik user. But do use Nginx. Why did you not specify your ports in your stack? Is there something special about Traefik?
@j0hnby

[j0hnby]

Hi @lastplace1990 - it's because the two containers are on the same docker network and I am not exposing the it-tools container itself externally. Anything on the same docker network can talk to each other without the ports being specified.

[lastplace1990]

Thanks for the understanding and explaining

[sharevb]

Hi @Rumpick , @j0hnby , @lastplace1990 , applied PR #56 to clarify port mapping of nginx-unpriviledged, don't know much about traefik, on my WSL2 + Docker, doing what I said here : https://github.com/sharevb/it-tools?tab=readme-ov-file#docker-compose-for-hosting-in-a-it-tools-subfolder, works

If anyone has a running configuration with traefik, I or someone with a PR could add it to README and/or a sample like above ? thanks

[supervirus]

Hi,

here es an example for Traefik v2 mostly based on the compose file given by @j0hnby :

services:
  it-tools:
    container_name: it-tools
    image: ghcr.io/sharevb/it-tools:baseurl-it-tools
    restart: unless-stopped
    environment:
      - TZ=Europe/London
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.${COMPOSE_PROJECT_NAME}.rule=Host(`site.mydomain.co.uk`) && PathPrefix(`/it-tools/`)"
      - "traefik.http.routers.${COMPOSE_PROJECT_NAME}.entrypoints=https"
      - "traefik.http.routers.${COMPOSE_PROJECT_NAME}.middlewares=${COMPOSE_PROJECT_NAME}-stripprefix"
      - "traefik.http.middlewares.${COMPOSE_PROJECT_NAME}-stripprefix.stripprefix.prefixes=/it-tools"
      - "traefik.http.services.${COMPOSE_PROJECT_NAME}.loadbalancer.server.port=8080"
    networks:
      - home-stack

networks:
  home-stack:
    external: true

The "magic" happens using the Traefik StripPrefix Middleware ,which removes the prefix /it-tools from the URL passed to the baseurl-it-tools container:

      - "traefik.http.routers.${COMPOSE_PROJECT_NAME}.middlewares=${COMPOSE_PROJECT_NAME}-stripprefix"
      - "traefik.http.middlewares.${COMPOSE_PROJECT_NAME}-stripprefix.stripprefix.prefixes=/it-tools"

This is necessary, as the baseurl-it-tools expects the URLs to be passed without the /it-tools prefix.

@sharevb I would suggest to change the nginx default.conf for the baseurl-it-tools image to include a rewrite directive to strip the /it-tools prefix if passed to container:

server {
    listen 8080;
    listen [::]:8080;
    server_name _;
    root /usr/share/nginx/html;
    index index.html;

    location / {
        rewrite ^/it-tools/(.*) /$1 break;
        try_files $uri $uri/ /index.html;
    }
}

This way it would work, indepent from the upstream proxy passing the prefix or not.

[j0hnby]

Nice @supervirus - the updated compose with the extra middleware works for me.

[sharevb]

Hi @supervirus , I also wonder if rewrite rule could just work in all cases, but may be not with nginx reverse since it alway remove prefix as far as I know

[supervirus]

Hi, I am unsure about nginx stripping the prefix, but it should work anyway.
The rewrite rule only applies if the prefix is in place.
It would only pose a problem, if there is a /it-tools route in the application itself.

[sharevb]

Hi @supervirus, @j0hnby , @Rumpick , @lastplace1990 , updated default.conf according to @supervirus , should be ok now without middleware