Add config to set URL for static assets

Add option in the controller config to set where static assets are
loaded from in order to support deployments where the static assets are
server via a CDN while the API is directly accessed.

This is useful because some CDNs put low limits on how large requests
bodies can be, which causes issues with uploading large mods and saves.
This commit is contained in:
Hornwitser committed 2026-08-31 19:17:31 +02:00
1 parent 0f1fbb8fe5
commit 7c0d7faa24
9 files changed
+81 -7

No files matched your search

+11
View File
@@ -60,6 +60,17 @@ This should be a full URL ending with a /.
Defaults to null meaning assume localhost.
### controller.static_url
Used to override where static assets such as the web bundle is loaded from.
This can be used if you want to put the static assets on a separate cdn url like `https://cdn.example.com/static/` while keeping the API hosted directly by clusterio.
Due to a limitation on how the webpack assets are built the pathname component of the url have to be `/static/`.
See also the `clusteriocontroller copy-static` command for how to obtain the static asset files that need to be hosted.
Defaults to null meaning use the internally hosted assets.
### controller.tls_certificate
Path to TLS certificate to use for the HTTPS server when controller.https_port is configured.