Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 8 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,18 +26,17 @@ The default MATLAB Web App Server deployment template uses the Network License M

# Deploy Reference Architecture for Your Release
To deploy the reference architecture, select your MATLAB Web App Server release from the table and follow the instructions to deploy the server using the provided template. A deployment of MATLAB Web App Server supports MATLAB Runtime versions up to six releases back.
| Release | Supported MATLAB Runtime Versions |
| ------- | --------------------------------- |
| [R2025a](releases/R2025a/README.md) | R2025a, R2024b, R2024a, R2023b, R2023a*, R2022b* |
| [R2024b](releases/R2024b/README.md) | R2024b, R2024a, R2023b, R2023a*, R2022b*, R2022a* |
| [R2024a](releases/R2024a/README.md) | R2024a, R2023b, R2023a, R2022b, R2022a, R2021b |
| [R2023b](releases/R2023b/README.md) | R2023b, R2023a, R2022b, R2022a, R2021b |
| [R2023a](releases/R2023a/README.md) | R2023a, R2022b, R2022a, R2021b, R2021a, R2020b |
| [R2022b](releases/R2022b/README.md) | R2022b, R2022a, R2021b, R2021a, R2020b, R2020a |
| Release | Supported MATLAB Runtime Versions | Status |
| ------- | --------------------------------- |--------|
| [R2025b](releases/R2025b/README.md) | R2025b, R2025a, R2024b, R2024a, R2023b, R2023a* | ✅ Template available. |
| [R2025a](releases/R2025a/README.md) | R2025a, R2024b, R2024a, R2023b, R2023a*, R2022b* | ✅ Template available. |
| [R2024b](releases/R2024b/README.md) | R2024b, R2024a, R2023b, R2023a*, R2022b*, R2022a* | ✅ Template available. |
| [R2024a](releases/R2024a/README.md) | R2024a, R2023b, R2023a, R2022b, R2022a, R2021b | ⚠️ Template will be removed in September 2026. |
| [R2023b](releases/R2023b/README.md) | R2023b, R2023a, R2022b, R2022a, R2021b | ⚠️ Template will be removed in March 2026. |

> \*When the server is configured to use MATLAB Runtime versions prior to R2023b, the `unsafe-inline` attribute is set in the `script-src` directive of the Content Security Policy on the server and cannot be disabled. This allows web apps with embedded JavaScript to execute on the server. These runtimes are disabled by default starting in R2024b. You can enable them using the [webapps-runtime](https://www.mathworks.com/help/webappserver/ref/webappsruntime.html) command.

**Note**: MathWorks provides templates for only the six most recent releases of MATLAB Web App Server. Earlier templates are removed and are no longer supported.
**Note**: MathWorks provides templates for only the five most recent releases of MATLAB Web App Server. Earlier templates are removed and are no longer supported.

# Architecture and Resources
Deploying this reference architecture creates several resources in your
Expand Down
220 changes: 0 additions & 220 deletions releases/R2022b/README.md

This file was deleted.

7 changes: 0 additions & 7 deletions releases/R2023a/templates.json

This file was deleted.

4 changes: 2 additions & 2 deletions releases/R2023b/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# MATLAB Web App Server on Amazon Web Services - R2023b

# Deployment Steps
Follow these steps to deploy the R2023b MATLAB Web App Server reference architecture on AWS. To deploy reference architectures for other releases, see [Deploy Reference Architecture for Your Release](/README.md#deploy-reference-architecture-for-your-release).
Follow these steps to deploy the R2023b MATLAB Web App Server reference architecture on AWS. To deploy reference architectures for other releases, see [Deploy Reference Architecture for Your Release](/README.md?tab=readme-ov-file#deploy-reference-architecture-for-your-release).
## Step 1. Launch Template
Before launching the template, make sure that you have selected one of these supported AWS regions from the top navigation:<ul><li>**US East (N. Virginia)**</li><li>**Europe (Ireland)**</li><li>**Asia Pacific (Tokyo)**</li></ul>

Expand All @@ -13,7 +13,7 @@ Then, click the appropriate **Launch Stack** button to launch the stack configur

The AWS Management Console opens in your web browser.

>**NOTE:** Multiple versions of MATLAB Runtime are supported. For details, see [Deploy Reference Architecture for Your Release](/README.md#deploy-reference-architecture-for-your-release).
>**NOTE:** Multiple versions of MATLAB Runtime are supported. For details, see [Deploy Reference Architecture for Your Release](/README.md?tab=readme-ov-file#deploy-reference-architecture-for-your-release).

>**NOTE:** Creating a stack on AWS can take at least 20 minutes.
><!--For other releases, see [How do I launch a template that uses a previous MATLAB release?](#how-do-i-launch-a-template-that-uses-a-previous-matlab-release)-->
Expand Down
4 changes: 2 additions & 2 deletions releases/R2024a/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# MATLAB Web App Server on Amazon Web Services - R2024a

# Deployment Steps
Follow these steps to deploy the R2024a MATLAB Web App Server reference architecture on AWS. To deploy reference architectures for other releases, see [Deploy Reference Architecture for Your Release](/README.md#deploy-reference-architecture-for-your-release).
Follow these steps to deploy the R2024a MATLAB Web App Server reference architecture on AWS. To deploy reference architectures for other releases, see [Deploy Reference Architecture for Your Release](/README.md?tab=readme-ov-file#deploy-reference-architecture-for-your-release).
## Step 1. Launch Template
Before launching the template, make sure that you have selected one of these supported AWS regions from the top navigation:<ul><li>**US East (N. Virginia)**</li><li>**Europe (Ireland)**</li><li>**Asia Pacific (Tokyo)**</li></ul>

Expand All @@ -13,7 +13,7 @@ Then, click the appropriate **Launch Stack** button to launch the stack configur

The AWS Management Console opens in your web browser.

>**NOTE:** Multiple versions of MATLAB Runtime are supported. For details, see [Deploy Reference Architecture for Your Release](/README.md#deploy-reference-architecture-for-your-release).
>**NOTE:** Multiple versions of MATLAB Runtime are supported. For details, see [Deploy Reference Architecture for Your Release](/README.md?tab=readme-ov-file#deploy-reference-architecture-for-your-release).

>**NOTE:** Creating a stack on AWS can take at least 20 minutes.
><!--For other releases, see [How do I launch a template that uses a previous MATLAB release?](#how-do-i-launch-a-template-that-uses-a-previous-matlab-release)-->
Expand Down
4 changes: 2 additions & 2 deletions releases/R2024b/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# MATLAB Web App Server on Amazon Web Services - R2024b

# Deployment Steps
Follow these steps to deploy the R2024b MATLAB Web App Server reference architecture on AWS. To deploy reference architectures for other releases, see [Deploy Reference Architecture for Your Release](/README.md#deploy-reference-architecture-for-your-release).
Follow these steps to deploy the R2024b MATLAB Web App Server reference architecture on AWS. To deploy reference architectures for other releases, see [Deploy Reference Architecture for Your Release](/README.md?tab=readme-ov-file#deploy-reference-architecture-for-your-release).
## Step 1. Launch Template
Before launching the template, make sure that you have selected one of these supported AWS regions from the top navigation:<ul><li>**US East (N. Virginia)**</li><li>**Europe (Ireland)**</li><li>**Asia Pacific (Tokyo)**</li></ul>

Expand All @@ -13,7 +13,7 @@ Then, click the appropriate **Launch Stack** button to launch the stack configur

The AWS Management Console opens in your web browser.

>**NOTE:** Multiple versions of MATLAB Runtime are supported. For details, see [Deploy Reference Architecture for Your Release](/README.md#deploy-reference-architecture-for-your-release).
>**NOTE:** Multiple versions of MATLAB Runtime are supported. For details, see [Deploy Reference Architecture for Your Release](/README.md?tab=readme-ov-file#deploy-reference-architecture-for-your-release).

>**NOTE:** Creating a stack on AWS can take at least 20 minutes.

Expand Down
10 changes: 5 additions & 5 deletions releases/R2025a/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# MATLAB Web App Server on Amazon Web Services - R2025a

# Deployment Steps
Follow these steps to deploy the R2025a MATLAB Web App Server reference architecture on AWS. To deploy reference architectures for other releases, see [Deploy Reference Architecture for Your Release](/README.md#deploy-reference-architecture-for-your-release).
Follow these steps to deploy the R2025a MATLAB Web App Server reference architecture on AWS. To deploy reference architectures for other releases, see [Deploy Reference Architecture for Your Release](/README.md?tab=readme-ov-file#deploy-reference-architecture-for-your-release).

## Prerequisites
Before deploying MATLAB Web App Server within an existing Virtual Private Cloud (VPC), you must configure the VPC to enable connectivity. For details, see [Ensure connectivity in an existing VPC](#ensure-connectivity-in-an-existing-vpc).
Expand All @@ -17,7 +17,7 @@ Then, click the appropriate **Launch Stack** button to launch the stack configur

The AWS Management Console opens in your web browser.

>**NOTE:** Multiple versions of MATLAB Runtime are supported. For details, see [Deploy Reference Architecture for Your Release](/README.md#deploy-reference-architecture-for-your-release).
>**NOTE:** Multiple versions of MATLAB Runtime are supported. For details, see [Deploy Reference Architecture for Your Release](/README.md?tab=readme-ov-file#deploy-reference-architecture-for-your-release).

>**NOTE:** Creating a stack on AWS can take at least 20 minutes.

Expand Down Expand Up @@ -95,7 +95,7 @@ Click the **Create** button. The CloudFormation service starts creating resource
## Step 6. Connect and Log In to the Admin Portal (Linux Server Only)
> **Note:** The Internet Explorer web browser is not supported for accessing the admin portal.

The MALAB Web App Server admin portal provides a web-based interface to configure and manage the server instance on the cloud. The admin portal is only available for servers deployed on Ubuntu Linux.
The MATLAB Web App Server admin portal provides a web-based interface to configure and manage the server instance on the cloud. The admin portal is only available for servers deployed on Ubuntu Linux. For more details on accessing and using the admin portal, see [Manage MATLAB Web App Server on AWS Using Admin Portal](https://www.mathworks.com/help/webappserver/ug/manage-matlab-web-app-server-using-admin-portal-on-aws-reference-architecture.html).

1. In the Stack details for your stack, click the **Outputs** tab.
1. Look for the key named `AdminPortalUrl` and click the corresponding URL listed under **value**. This opens the admin portal Overview page.
Expand Down Expand Up @@ -131,7 +131,7 @@ To run applications on MATLAB Web App Server, you need to create web apps using
## Step 8. Configure User Authentication

### Linux Server
On Linux servers, user authentication to the admin portal and MATLAB Web App Server home page is administered by default through [Keycloak](https://www.keycloak.org/docs/latest/server_admin/index.html). Keycloak is a cloud native solution that provides authentication, authorization, and user management for applications and services. You can configure authentication using your identity provider with Keycloak or directly using LDAP or OIDC.
On Linux servers, user authentication to the admin portal and MATLAB Web App Server home page is administered by default through [Keycloak](https://www.keycloak.org/docs/latest/server_admin/index.html). Keycloak is a cloud native solution that provides authentication, authorization, and user management for applications and services. You can configure authentication using your identity provider with Keycloak or directly using LDAP or OIDC. For more details, see [Configure Authentication for MATLAB Web App Server on AWS](https://www.mathworks.com/help/webappserver/ug/configure-authentication-for-matlab-web-app-server-on-aws.html).

After you deploy MATLAB Web App Server, log in to the Keycloak administration console to configure user authentication and change the default admin credentials.
1. In the Stack details for your stack, click the **Outputs** tab.
Expand All @@ -145,7 +145,7 @@ After you deploy MATLAB Web App Server, log in to the Keycloak administration co

There are three pre-configured user accounts and three groups in Keycloak. Each user account belongs to one or more groups, and each group grants specific permissions on the MATLAB Web App Server. For example, the `matlab-webapps-admin` user inherits the ability to upload and delete apps from the **MATLAB Web App Server Authors** group. Add or modify groups and users as needed through the Keycloak admin console. For more information, see [Managing users](https://www.keycloak.org/docs/latest/server_admin/index.html#assembly-managing-users_server_administration_guide) in the Keycloak documentation.

To allow an existing group to access additional resources on the MATLAB Web App Server, use the **App Management/Access Control** page of the admin portal. For example, you could assign all members of the **MATLAB Web App Server Users** group execute permissions for all apps in the root level folder.
To allow an existing group to access additional resources on the MATLAB Web App Server, use the **App Management/Access Control** page of the admin portal. For example, you could assign all members of the **MATLAB Web App Server Users** group execute permissions for all apps at the root level.


### Windows Server
Expand Down
Loading