From 240374ae5f9bf79d2893d5d6cea1fc384e78b89e Mon Sep 17 00:00:00 2001
From: John Gaughan <jgaughan@gitlab.com>
Date: Wed, 19 Jul 2023 16:23:44 +0000
Subject: [PATCH] PlantUML troubleshooting section

---
 doc/administration/integration/plantuml.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/administration/integration/plantuml.md b/doc/administration/integration/plantuml.md
index f05197d45e7ad..6755d5c8f85bc 100644
--- a/doc/administration/integration/plantuml.md
+++ b/doc/administration/integration/plantuml.md
@@ -291,6 +291,14 @@ The default URL is different when using this approach. The Docker-based image
 makes the service available at the root URL, with no relative path. Adjust
 the configuration below accordingly.
 
+#### `404` error when opening the PlantUML page in the browser
+
+You might get a `404` error when visiting `https://gitlab.example.com/-/plantuml/`, when the PlantUML
+server is set up [in Debian or Ubuntu](#debianubuntu).
+
+This can happen even when the integration is working.
+It does not necessarily indicate a problem with your PlantUML server or configuration.
+
 ### Configure PlantUML security
 
 PlantUML has features that allow fetching network resources. If you self-host the
-- 
GitLab