From 0ce79bb9f6d9bb070ff53d08a939112005ac3564 Mon Sep 17 00:00:00 2001 From: Joakim Pettersen Date: Thu, 23 Feb 2023 08:34:09 +0100 Subject: [PATCH] Improve reverse proxies documentation (#23068) Add "Traefik with a sub-path" documentation closes #23047 Co-authored-by: techknowlogick --- .../doc/usage/reverse-proxies.en-us.md | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/content/doc/usage/reverse-proxies.en-us.md b/docs/content/doc/usage/reverse-proxies.en-us.md index 5797d8e5e..b8cebee57 100644 --- a/docs/content/doc/usage/reverse-proxies.en-us.md +++ b/docs/content/doc/usage/reverse-proxies.en-us.md @@ -365,3 +365,23 @@ gitea: ``` This config assumes that you are handling HTTPS on the traefik side and using HTTP between Gitea and traefik. + +## Traefik with a sub-path + +In case you already have a site, and you want Gitea to share the domain name, you can setup Traefik to serve Gitea under a sub-path by adding the following to your `docker-compose.yaml` (Assuming the provider is docker) : + +```yaml +gitea: + image: gitea/gitea + ... + labels: + - "traefik.enable=true" + - "traefik.http.routers.gitea.rule=Host(`example.com`) && PathPrefix(`/gitea`)" + - "traefik.http.services.gitea-websecure.loadbalancer.server.port=3000" + - "traefik.http.middlewares.gitea-stripprefix.stripprefix.prefixes=/gitea" + - "traefik.http.routers.gitea.middlewares=gitea-stripprefix" +``` + +This config assumes that you are handling HTTPS on the traefik side and using HTTP between Gitea and traefik. + +Then you **MUST** set something like `[server] ROOT_URL = http://example.com/gitea/` correctly in your configuration.