Issue: Setting-up dedicated PlantUML server for wiki.js

[Congenial-GmbH]

I am running wiki.js using Ubuntu and Docker according to the official Ubuntu setup-guide and would like to run my own PlantUML server on the same instance as described in Quick Start Guide to PlantUML:

Steps taken:

1. Set up a new wiki.js instance acc. to official Ubuntu setup-guide .
2. Set up a PlantUML server using Docker:

   docker run -d -p 8080:8080 plantuml/plantuml-server:jetty

3. Configured Wiki.js to use the PlantUML server:

• wiki.js: Administration ▸ Rendering ▸ PlantUML
• Field: "PlantUML Server"
• Populated value: http://localhost:8080 (or http://localhost:8080/plantuml)

4. Created a PlantUML diagram in the Markdown editor:

   ```plantuml
   @startuml
   Bob -> Alice : hello
   @enduml
   ```
   

Issue:
The diagram renders correctly in the edit mode preview but shows 'uml diagram' instead of the rendered diagram after saving and exiting the page.

Additional Notes:

• Docker container for PlantUML is running (acc. to docker ps)
• PlantUML service can be reached from browser at http://<ip-address>:8080 and seems to work fine.
  (Note: I will set-up SSL certifiacte later).

[Congenial-GmbH]

I made the following additional observations:

Very simple diagrams such as:

```plantuml
digraph G {
   A -> B
}
```

are rendered correctly when I exit the markdown editor.

More complex ones fail, and they also fail on the web-frontend http://<ip-address>:8080 unless I adjust Settings "Editor Watcher Timeout" to a large number, such as 5000.

I therefore suppose, I need to run my docker container with adjusted options as described at How to set PlantUML options, e.g.

docker run -d -p 8080:8080 -e HTTP_PROXY_READ_TIMEOUT=20000 plantuml/plantuml-server:jetty

However, this time-out does not seem to be the reason why PlantUML rendering fails when exiting the markdown editor in wiki.js.

Does anyone have an idea how to resolve this issue?

[CleyFaye]

Note that configuring the plantuml rendering server in the wikijs admin have no effect on the editor preview, as requests will be sent to plantuml.requarks.io anyway. So, the editor preview working is no indication that your local setup works.

When the markdown page is rendered, it creates an img tag that will reference your configured plantuml render server from the client; meaning that if you configured your plantuml render server to be "http://localhost:8080", the client will try to connect to localhost when the page is displayed. This may or may not be what you want.

As far as I know, there is no option for wikijs to generate the image, store it, and serve it instead of linking to the plantuml render server.