Skip to content

Commit 78d12d1

Browse files
simonbrowndotjesimonbrowndotje
committed
Updates docs following release.
1 parent fa16bd8 commit 78d12d1

7 files changed

Lines changed: 73 additions & 21 deletions

File tree

‎binaries.md‎

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,20 +5,21 @@ title: Prebuilt binaries
55
nav_order: 8
66
---
77

8-
# Prebuilt Binaries
8+
# Prebuilt binaries
99

1010
Prebuilt binaries are provided as a Docker image and Java .war file.
1111
All Structurizr [commands](/commands) are free to use from these binaries except for [server](/server), which requires a license (see [pricing](/server/pricing)).
1212

13-
> You can use the open core version of [server](/server) for free by [building from source](/building).
13+
- Latest release: 2026.04.19
1414

1515
## Docker image
1616

1717
- Requires Docker
1818
- Image name: [structurizr/structurizr](https://hub.docker.com/r/structurizr/structurizr)
1919
- Tags:
20-
- `latest`: The latest release.
21-
- `preview`: A preview build, not intended for production use.
20+
- `2026.04.19` and `latest`: [Hardened Eclipse Temurin 21 - Alpine](https://hub.docker.com/hardened-images/catalog/dhi/eclipse-temurin) base image for general production use.
21+
- `2026.04.19-playwright`: Non-hardened [Playwright for Java - Noble](https://mcr.microsoft.com/en-us/artifact/mar/playwright/java) base image that includes the Microsoft Playwright dependencies required to use the PNG/SVG export feature.
22+
- `preview`: Non-hardened [Playwright for Java - Noble](https://mcr.microsoft.com/en-us/artifact/mar/playwright/java) base image, not intended for production use.
2223

2324
Pull the latest version of the Docker image:
2425

@@ -37,19 +38,21 @@ In this example, `$PWD` will mount the current local directory as the working di
3738
## Java .war file
3839

3940
- Requires Java 21
40-
- Latest release: [structurizr-2026.03.06.war](https://download.structurizr.com/structurizr-2026.03.06.war)
41-
- Preview build: [structurizr-preview.war](https://download.structurizr.com/structurizr-preview.war) (not intended for production use)
41+
- Downloads:
42+
- [structurizr-2026.04.19.war](https://download.structurizr.com/structurizr-2026.04.19.war) and [structurizr.war](https://download.structurizr.com/structurizr.war): Excludes Microsoft Playwright dependencies.
43+
- [structurizr-2026.04.19-playwright.war](https://download.structurizr.com/structurizr-2026.04.19-playwright.war): Includes Microsoft Playwright dependencies.
44+
- [structurizr-preview.war](https://download.structurizr.com/structurizr-preview.war): A preview build, includes Microsoft Playwright dependencies, not intended for production use.
4245

4346
Download the file, either by clicking the link above or via the command line:
4447

4548
```
46-
curl -O https://download.structurizr.com/structurizr-2026.03.06.war
49+
curl -O https://download.structurizr.com/structurizr.war
4750
```
4851

4952
Start Structurizr:
5053

5154
```
52-
java -jar structurizr-2026.03.06.war <command> [parameters]
55+
java -jar structurizr.war <command> [parameters]
5356
```
5457

5558
## Community builds

‎commands/03-server/01-pricing.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,9 @@ Using the Structurizr server via our [prebuilt binaries](/binaries) requires a l
2222

2323
## Trial period
2424

25-
No trial license key is required - a trial period of 30 days is granted to you after starting the Structurizr server for the first time from the prebuilt binaries, after which you will be required to discontinue use or purchase a license.
25+
A trial period of 14 days is available to you by requesting a trial license from [trial.structurizr.com](https://trial.structurizr.com).
26+
27+
To use it, configure a property named `structurizr.license`, with the value being your license key. You will need to restart the server for this to take effect.
2628

2729
## Purchasing
2830

@@ -31,7 +33,7 @@ Please contact [hello@structurizr.com](mailto:hello@structurizr.com) for a quote
3133
- License size: small, medium, large, or enterprise (and number of unique users).
3234
- Name of the organisation/team that the license is to be assigned to.
3335
- Billing address, contact name and email address, that the invoice is to be sent to.
34-
- Email address that the licence key is to be sent to.
36+
- Email address that the license key is to be sent to.
3537
- Preferred payment method - bank transfer or PayPal.
3638

3739
## Frequently asked questions (FAQ)

‎commands/03-server/05-data-storage/02-amazon-web-services-s3.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -18,15 +18,15 @@ The basic steps to configure AWS S3 data storage are:
1818

1919
## Configuration
2020

21-
| Name | Value |
21+
| Name | Value |
2222
|------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
2323
| `structurizr.data` | `aws-s3` |
24-
| `aws-s3.accessKeyId` | AWS API key ID |
25-
| `aws-s3.secretAccessKey` | AWS API secret access key |
26-
| `aws-s3.region` | AWS region (e.g. `us-east-1`) |
27-
| `aws-s3.bucketName` | S3 bucket name |
28-
| `aws-s3.endpoint` | S3-compatible endpoint |
29-
| `aws-s3.pathStyleAccess` | Enables [path-style access](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#path-style-access) (default=`false`) |
24+
| `aws.s3.accessKeyId` | AWS API key ID |
25+
| `aws.s3.secretAccessKey` | AWS API secret access key |
26+
| `aws.s3.region` | AWS region (e.g. `us-east-1`) |
27+
| `aws.s3.bucketName` | S3 bucket name |
28+
| `aws.s3.endpoint` | S3-compatible endpoint |
29+
| `aws.s3.pathStyleAccess` | Enables [path-style access](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#path-style-access) (default=`false`) |
3030
| `structurizr.maxWorkspaceVersions` | The number of workspace versions to retain (default=`30`) |
3131
| `structurizr.encryption` | Passphrase to enable server-side encryption (default=) |
3232

‎commands/03-server/05-data-storage/03-microsoft-azure-blob-storage.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,11 @@ The basic steps to configure Azure Blob Storage are:
1717

1818
## Configuration
1919

20-
| Name | Value |
20+
| Name | Value |
2121
|------------------------------------|---------------------------------------------------------------------------------------------------------|
2222
| `structurizr.data` | `azure-blob` |
23-
| `azure-blob.accountName` | Azure data storage account name (just `xxx`, not the full URL of `https://xxx.blob.core.windows.net`) |
24-
| `azure-blob.accessKey` | Azure Blob Storage access key |
25-
| `azure-blob.containerName` | Azure Blob Storage container name |
23+
| `azure.blob.accountName` | Azure data storage account name (just `xxx`, not the full URL of `https://xxx.blob.core.windows.net`) |
24+
| `azure.blob.accessKey` | Azure Blob Storage access key |
25+
| `azure.blob.containerName` | Azure Blob Storage container name |
2626
| `structurizr.maxWorkspaceVersions` | The number of workspace versions to retain (default=`30`). |
2727
| `structurizr.encryption` | Passphrase to enable server-side encryption (default=) |

‎commands/04-export/01-plantuml.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,7 @@ The following properties can either be set on individual views, or on the view s
3131

3232
- `plantuml.title`: `true` (default) to include diagram titles, `false` to exclude diagram titles.
3333
- `plantuml.includes`: a comma separated list of file names that should be included (via `!include`) in the diagram definition.
34+
- `plantuml.skinparams`: a comma separated list of skinparams (in the form `name=value`) that should be included in the diagram definition.
3435
- `plantuml.sequenceDiagram`: `true` to generate a UML sequence diagram, `false` (default) to generate a collaboration diagram (dynamic views only).
3536
- `plantuml.animation`: `true` to generate one PlantUML diagram definition per animation frame, `false` (default) to ignore animations.
3637

‎commands/04-export/02-c4plantuml.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,7 @@ The following properties can either be set on individual views, or on the view s
2828

2929
- `plantuml.title`: `true` (default) to include diagram titles, `false` to exclude diagram titles.
3030
- `plantuml.includes`: a comma separated list of file names that should be included (via `!include`) in the diagram definition.
31+
- `plantuml.skinparams`: a comma separated list of skinparams (in the form `name=value`) that should be included in the diagram definition.
3132
- `plantuml.sequenceDiagram`: `true` to generate a UML sequence diagram, `false` (default) to generate a collaboration diagram (dynamic views only).
3233
- `plantuml.animation`: `true` to generate one PlantUML diagram definition per animation frame, `false` (default) to ignore animations.
3334
- `c4plantuml.tags`: `true` to generate diagram definitions based upon how the Structurizr diagram renderer creates diagrams using tags and styles, `false` (default) to generate diagram definitions that use the default C4-PlantUML styling (i.e. blue and grey boxes). Please note that with this property set to `true`, this exporter does not follow the approach that C4-PlantUML uses for tags and styling. If you would like this behaviour instead of what is provided here, you may want to take a look at [https://github.com/cloudflightio/structurizr-export-c4plantuml](https://github.com/cloudflightio/structurizr-export-c4plantuml) instead.

‎dsl/cookbook/deployment-groups/index.md‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,6 +100,51 @@ workspace {
100100

101101
[![](example-2.png)](https://playground.structurizr.com?src=https://docs.structurizr.com/dsl/cookbook/deployment-groups/example-2.dsl)
102102

103+
Deployment groups can also be set on deployment nodes rather than being specified for every software system instance or container instance:
104+
105+
```
106+
workspace {
107+
108+
model {
109+
softwareSystem = softwareSystem "Software System" {
110+
database = container "Database Schema"
111+
api = container "Service API" {
112+
-> database "Uses"
113+
}
114+
}
115+
116+
production = deploymentEnvironment "Production" {
117+
serviceInstance1 = deploymentGroup "Service instance 1"
118+
serviceInstance2 = deploymentGroup "Service instance 2"
119+
120+
deploymentNode "Server 1" {
121+
deploymentGroup serviceInstance1
122+
123+
containerInstance api
124+
deploymentNode "Database Server" {
125+
containerInstance database
126+
}
127+
}
128+
deploymentNode "Server 2" {
129+
deploymentGroup serviceInstance2
130+
131+
containerInstance api
132+
deploymentNode "Database Server" {
133+
containerInstance database
134+
}
135+
}
136+
}
137+
}
138+
139+
views {
140+
deployment * production {
141+
include *
142+
}
143+
}
144+
145+
}
146+
```
147+
103148
## Links
104149

105150
- [DSL language reference - deploymentGroup](/dsl/language#deploymentGroup)

0 commit comments

Comments
 (0)