Upgrade Polyspace Access

R2026b

Upgrade your Polyspace^® Access™ Docker Compose installation to a newer version.

Before starting the upgrade:

Back up your .env file. The new .env file might include new variables or different default values. Use your backup to transfer your current settings to the new file.
Back up your database. See Back Up Polyspace Access Database.
Note the current version of your Docker^® images. You can check the image tags in your current .env file in the Docker Images section.

To upgrade Polyspace Access:

Stop the running services:
```
docker compose down
```
Download the new version of Polyspace Access from the MathWorks^® Downloads page. Extract the zip file to a new directory.
Compare the new .env file from the extracted zip with your backed up .env file. Transfer your custom settings (gateway hostname, database passwords, LDAP/SAML configuration, issue tracker settings) to the new file.
Start the services with the updated configuration:
```
docker compose up -d
```
Verify the upgrade by checking the service status and opening the Polyspace Access web interface. See Verify Your Installation.

If the upgrade is unsuccessful, you can roll back to the previous version:

Stop the services:
```
docker compose down
```
Replace the new .env file with your backup.
Restore the database backup. See Back Up Polyspace Access Database.
Start the services with the original configuration:
```
docker compose up -d
```

See Also