The on-premises UI is a standalone version of Structurizr that can be run locally on your own servers, providing all of the major features needed to visualise, document and explore your software architecture.
A demo of the on-premises UI can be found at https://onpremises-demo.structurizr.com - please note that this installation is for demo purposes only, all data is publicly accessible and will be regularly deleted without notice.
An error message saying "404 Not Found: Requested route ('onpremises-demo.structurizr.com') does not exist.", probably means that a new version is being deployed. Please try again in a couple of minutes.
The on-premises UI is a Java EE web application, packaged as a
.war file for deployment into any compatible Java EE server such as Apache Tomcat.
Here are some basic instructions that assume you are using a freshly downloaded version of Apache Tomcat.
In the instructions that follow,
TOMCAT_HOME refers to the location of the Apache Tomcat installation.
After downloading the on-premises UI, copy the
TOMCAT_HOME/webapps/ROOT.war. The on-premises UI must be installed as the root web application.
Delete the existing
ROOT directory if it exists.
You then need to add some configuration information.
To do this, create a file called
ROOT.xml in the
with the following content (replacing
... with your license key).
<Context> <Environment name="structurizr/dataDirectory" value="/usr/local/structurizr" type="java.lang.String"/> <Environment name="structurizr/license" value="..." type="java.lang.String"/> </Context>
The parameters being configured in this file are as follows.
structurizr/dataDirectory: The location where Structurizr data will be stored.
structurizr/license: The Structurizr on-premises license key.
After starting Apache Tomcat, you should be able to navigate to
http://localhost:8080 in your browser.
Using the on-premises UI is much the same as the cloud version. Simply create a workspace using the "Create a new workspace" link on the home page, make a note of the API key/secret pair and upload your workspace content via Java or C# code using the on-premises API.
Cloud service vs on-premises product
The key differences between the cloud service and the on-premises UI are as follows:
The role-based security features have been taken out to simplify deployment, operation and support.
If you need additional security, you can either modify the
web.xmlfile to add security constraints or place the on-premises UI behind (e.g.) Apache, and let that manage access control or single-sign on.
- Structurizr Express is not available.
The cloud service and on-premises product share a common codebase, so any updates made to the cloud service are
immediately available in the on-premises product. To update, simply download a new version of the
.war file, overwrite the existing version and restart your web/application server.
Pricing and licensing
The on-premises UI is available as a perpetual license, with support and updates included for one year.