Frequently asked questions

Here are answers to some frequently asked questions. If you don't see an answer you are looking for, please get in touch.

What are the minimum hardware requirements?

The on-premises installation will happily run on a laptop, supporting hundreds of concurrent users, so any small server with a few GB of RAM should be sufficient for most teams.

Why don't you provide a pre-built Docker image?

The majority of our on-premises customers are very security conscious, and most will not deploy a pre-built Docker image, so we don't provide one. The on-premises installation is packaged as a .war file, so it's straightforward to create your own using something like this:

FROM tomcat:9.0.41-jdk11-openjdk

ADD structurizr-onpremises-xxxx.war /usr/local/tomcat/webapps/ROOT.war

ENV CATALINA_OPTS="-Xms512M -Xmx512M"
EXPOSE 8080

CMD ["catalina.sh", "run"]

Can the on-premises version of Structurizr be installed on public cloud IaaS and PaaS services?

The on-premises version is designed to run inside a trusted network environment, but some of our customers have installed it on environments such as the public Amazon Web Services and Microsoft Azure clouds. Please ensure that you consider the security implications of doing this, and that you harden any servers and restrict access where appropriate.

Can I install the on-premises version more than once?

The license covers a single "installation". You do not need multiple licenses to run a single installation in a clustered configuration (i.e. multiple instances of the on-premises application that connect to the same workspace data).

Can the on-premises installation be clustered for high availability?

Yes, the high availability add-on provides support for external data storage. At this time, Amazon S3 and Elasticsearch are supported.

Does the on-premises installation require an Internet connection?

No, the on-premises installation runs completely disconnected from the Internet. Furthermore, it doesn't make any requests to the Internet if there is an Internet connection (e.g. to check for updates).

Does the on-premises installation automatically update itself?

There is no auto-update mechanism, so new versions of the Structurizr on-premises installation need to be applied manually. The cloud service and on-premises installation share a common codebase, so any updates made to the cloud service are immediately available in the on-premises installation. To update, download a new version of the .war file, overwrite the existing version and restart your web/application server. We recommend scripting your deployments, and ensuring that you can easily rollback if needed.

Can the on-premises installation run over HTTPS?

Yes, see On-premises installation - Deployment - HTTPS for details.