On-premises installationOverview | Getting started | Configuration | Troubleshooting | FAQ
Authentication | LDAP | SAML 2.0 | Authorisation and role-based access | HTTPS | Amazon Web Services S3 | Elasticsearch
The Structurizr on-premises installation is licensed to you by Structurizr Limited for use strictly in accordance with the terms of the End User License Agreement.structurizr-onpremises.war (build 2828) Docker Hub
Here are some common problems, and how to resolve them.
The home page loads, but doesn't look right
If you can see the home page, but it doesn't look right (e.g. the styles don't seem to be loading, images are oversized, etc),
you will likely need to explicitly set the
structurizr.url property. See On-premises installation - Configuration for details.
The on-premises installation cannot be accessed or is not found
As detailed in the deployment guide, the on-premises installation needs to be run as the root/default web application/context.
For Apache Tomcat, this means the web application named
ROOT, running at
It is not possible to run the on-premises installation with an alternative context (e.g.
Embedded diagrams don't load
If you have installed the on-premises installation behind a reverse proxy, be aware that some reverse proxies will add additional HTTP headers, which may override those generated/used by the on-premises installation, causing issues such as the embedded diagram viewer/editor not working. The following headers may need to be disabled in your reverse proxy if they are being set:
Diagram reviews fail to be created
Some web servers (e.g. Apache Tomcat) restrict the quantity of data that can be sent in a HTTP POST request.
If you find that creating diagram reviews fails, you may need to change this configuration.
For Apache Tomcat, you can modify the
maxPostSize parameter for your connector in the
server.xml file (see https://tomcat.apache.org/tomcat-9.0-doc/config/http.html).