Check your configuration files

Oct 13, 2025 by wbrum.org 104 views

Introduction

As a user of the PlantUML self-hosted instance, you may encounter issues with host override on different subdomains. This article aims to provide a solution to this problem, which is particularly relevant for users who have multiple services running on their server, such as PlantUML and SilverBullet. We will explore the issue, its impact, and the possible solutions, including the use of the serverurl configuration in SilverBullet settings.

The Issue

When using a self-hosted instance of PlantUML, you may encounter issues with host override on different subdomains. In your server, you may have multiple services running on different subdomains, such as plantuml.myhost.local and silverbullet.myhost.local. However, when you define the serverurl configuration in SilverBullet settings, it may not work as expected.

For example, if you define the following configuration in SilverBullet settings:

plantuml:
  serverurl: https://plantuml.myhost.local

You may expect SilverBullet to fetch data from https://plantuml.myhost.local/plantuml/svg.... However, in some cases, SilverBullet may fetch data from https://silverbullet.myhost.local/!plantuml.myhost.local/plantuml/svg... instead. This issue is particularly problematic when you have multiple services running on your server, and you need to use different subdomains for each service.

The Impact

The issue with host override on different subdomains can have a significant impact on your workflow. If you are using a self-hosted instance of PlantUML, you may encounter issues with rendering diagrams, which can lead to frustration and decreased productivity. Moreover, if you are using a plugin like SilverBullet, you may experience issues with data fetching, which can further exacerbate the problem.

Possible Solutions

There are several possible solutions to this issue, including:

Using the serverurl configuration: As mentioned earlier, you can define the serverurl configuration in SilverBullet settings to specify the URL of your PlantUML instance. However, this may not work as expected in all cases, particularly when you have multiple services running on your server.
Using a different plugin: If you are experiencing issues with SilverBullet, you may want to consider using a different plugin that supports host override on different subdomains.
Configuring your server: You may need to configure your server to allow host override on different subdomains. This may involve modifying your server's configuration files or using a reverse proxy server.

Using the Edge Version

If you are experiencing issues with the stable version of SilverBullet, you may want to consider using the edge version. The edge version is a development version of SilverBullet that includes the latest features and bug fixes. You can download the edge version from the SilverBullet GitHub repository.

Conclusion

In conclusion, host override on different subdomains can be a challenging issue for users of the PlantUML self-hosted instance. However, by using the serverurl configuration, a different plugin, or configuring your server, you can resolve this issue and ensure that your workflow is not impacted. If you are experiencing issues with SilverBullet, you may want to consider using the edge version, which includes the latest features and bug fixes.

Troubleshooting

If you are experiencing issues with host override on different subdomains, you may want to try the following troubleshooting steps:

Check your configuration files: Ensure that your configuration files are correct and that you have defined the serverurl configuration in SilverBullet settings.
Check your server configuration: Ensure that your server is configured to allow host override on different subdomains.
Check the SilverBullet logs: Check the SilverBullet logs to see if there are any error messages that may indicate the cause of the issue.
Try using a different plugin: If you are experiencing issues with SilverBullet, you may want to consider using a different plugin that supports host override on different subdomains.

FAQs

Q: What is host override on different subdomains? A: Host override on different subdomains is a feature that allows you to use different subdomains for different services running on your server.

Q: Why is host override on different subdomains important? A: Host override on different subdomains is important because it allows you to use different subdomains for different services running on your server, which can improve your workflow and productivity.

Q: How can I resolve issues with host override on different subdomains? A: You can resolve issues with host override on different subdomains by using the serverurl configuration, a different plugin, or configuring your server.

Q: What is the edge version of SilverBullet? A: The edge version of SilverBullet is a development version of SilverBullet that includes the latest features and bug fixes.

Q: What is host override on different subdomains?

A: Host override on different subdomains is a feature that allows you to use different subdomains for different services running on your server. This feature is particularly useful when you have multiple services running on your server, and you need to use different subdomains for each service.

Q: Why is host override on different subdomains important?

A: Host override on different subdomains is important because it allows you to use different subdomains for different services running on your server, which can improve your workflow and productivity. For example, if you are using a self-hosted instance of PlantUML, you may need to use a different subdomain for each service, such as plantuml.myhost.local and silverbullet.myhost.local.

Q: How can I resolve issues with host override on different subdomains?

A: You can resolve issues with host override on different subdomains by using the serverurl configuration, a different plugin, or configuring your server. Here are some possible solutions:

Using the serverurl configuration: You can define the serverurl configuration in SilverBullet settings to specify the URL of your PlantUML instance.
Using a different plugin: If you are experiencing issues with SilverBullet, you may want to consider using a different plugin that supports host override on different subdomains.
Configuring your server: You may need to configure your server to allow host override on different subdomains. This may involve modifying your server's configuration files or using a reverse proxy server.

Q: What is the `serverurl` configuration?

A: The serverurl configuration is a setting in SilverBullet that allows you to specify the URL of your PlantUML instance. You can define the serverurl configuration in SilverBullet settings to specify the URL of your PlantUML instance.

Q: How do I define the `serverurl` configuration in SilverBullet settings?

A: To define the serverurl configuration in SilverBullet settings, you can add the following configuration to your SilverBullet settings file:

plantuml:
  serverurl: https://plantuml.myhost.local

Q: What is the edge version of SilverBullet?

A: The edge version of SilverBullet is a development version of SilverBullet that includes the latest features and bug fixes. The edge version is available on the SilverBullet GitHub repository.

Q: How can I download the edge version of SilverBullet?

A: You can download the edge version of SilverBullet from the SilverBullet GitHub repository. To download the edge version, follow these steps:

Go to the SilverBullet GitHub repository.
Click on the "Releases" tab.
Click on the "Edge" version.
Click on the "Download" button.

Q: What are the benefits of using the edge version of SilverBullet?

A: The edge version of SilverBullet includes the latest features and bug fixes, which can improve your workflow and productivity. Additionally, the edge version may include new features and improvements that are not available in the stable version.

Q: How can I report issues with host override on different subdomains?

A: If you are experiencing issues with host override on different subdomains, you can report the issue on the SilverBullet GitHub repository. To report an issue, follow these steps:

Go to the SilverBullet GitHub repository.
Click on the "Issues" tab.
Click on the "New issue" button.
Fill out the issue form with the necessary information.
Click on the "Submit" button.

Q: How can I get help with host override on different subdomains?

A: If you are experiencing issues with host override on different subdomains, you can get help from the SilverBullet community. To get help, follow these steps:

Go to the SilverBullet GitHub repository.
Click on the "Issues" tab.
Search for existing issues related to host override on different subdomains.
Check the issue comments for possible solutions.
If you cannot find a solution, create a new issue and provide the necessary information.

Q: What are some common issues with host override on different subdomains?

A: Some common issues with host override on different subdomains include:

Incorrect configuration: Incorrect configuration of the serverurl configuration or other settings can cause issues with host override on different subdomains.
Server configuration: Server configuration issues, such as incorrect DNS settings or firewall rules, can cause issues with host override on different subdomains.
Plugin issues: Plugin issues, such as compatibility problems or bugs, can cause issues with host override on different subdomains.

Q: How can I troubleshoot issues with host override on different subdomains?

A: To troubleshoot issues with host override on different subdomains, follow these steps:

Check your configuration files for errors.
Check your server configuration for errors.
Check the SilverBullet logs for error messages.
Try using a different plugin or configuration.
Report the issue on the SilverBullet GitHub repository.