Release notes for Self-Hosted Deployment on-premises

Learn about new features, improvements, and changes in each release of Self-Hosted Deployment On-Premises

읽는 시간 30분

최근 업데이트: 8일 전

Version 0.16.0 — August 12, 2026

Upgrade vpctl to 0.13.0 or newer before you pull and deploy this release.

New features

Validate your cluster before you deploy

vpctl 0.13.0 adds the

cluster check

command, which verifies that the cluster your current kubeconfig context points at meets the deployment prerequisites:


vpctl cluster check

Run it before you pull the release, after any cluster change, and before every upgrade. For the full list of checks and options, refer to vpctl cluster command.

Built-in Optimize and Convert 3D Asset pipeline

Deployment now installs, certifies, and publishes an Optimize and Convert 3D Asset transformation pipeline to the Asset Manager for all organizations without manual setup.

The pipeline's steps run the Unity Asset Manager and Unity Asset Transformer (Pixyz) app versions that your deployment already installs, so the pipeline always matches the apps present on the cluster.

The post-deployment

automation-manager

job reconciles the pipeline on every upgrade and fills in only what's missing, so a pipeline version that's already installed is left untouched.

If the installation fails, the job reports it in its log without blocking the rest of the deployment.

If you don't want to install the pipeline, set the

automation-manager

value

env.pipelinesList

to an empty string.

Asset collaboration service uses PostgreSQL

The asset collaboration service now connects to PostgreSQL, in the

collaboration

database.

Action required: this adds a new secret field. Regenerate your secrets and redeploy so that the service picks up its PostgreSQL connection string:


vpctl secret generate --import secrets.import.yaml --use-defaultsvpctl secret deploy

Repair script for Unity Version Control data volumes

The release package now includes a repair script for Unity Version Control (UVCS) data volumes at

common/scripts/fix-uvcs-jet-ownership.sh

A volume that an older UVCS version created holds files owned by

root

. Now that the server runs as a non-root user, every write to those files logs

Unable to update timestamp of file '/jet/...': Access to the path ... is denied

. UVCS keeps serving requests, but the errors fill its logs.

From the extracted release, run the read-only check to find out whether your deployment is affected:


./common/scripts/fix-uvcs-jet-ownership.sh check

If it is, correct the ownership:


./common/scripts/fix-uvcs-jet-ownership.sh repair

The repair runs a short-lived job and briefly restarts UVCS. Deployments whose volume was created by a recent release aren't affected and need no action.

Improvements

Requiring action

Built-in automation apps updated. Unity Asset Transformer (Pixyz) and Unity Asset Manager are both updated to 1.2.1. The updated versions are registered alongside the existing ones at deployment time. Automations you already created stay on the app version they were created with and keep working, because the images those versions need remain in the registry mirror. To use the updated app in an existing automation, recreate the automation against the new app version.
Quieter Unity Version Control logs. The UVCS server now logs at
```
INFO
```
level by default instead of
```
DEBUG
```
, which sharply reduces its log output and its disk and log-ingestion footprint. For a support investigation, you can temporarily restore verbose logging by setting the environment variable
```
UVCS_LOG_LEVEL=DEBUG
```
on the UVCS container.
Collaboration and automation API routes regenerated. Both sets of routes are now generated from Unity Services Gateway v2 definitions. Redeploy to pick up the regenerated Traefik routes.
EKS add-ons upgrade automatically. The
```
baseline-example
```
Terraform now installs and upgrades EKS add-ons to the latest version compatible with the cluster's Kubernetes version on every
```
terraform apply
```
, so add-on versions no longer need manual bumping. The
```
addon_*_version
```
Terraform variables are removed: delete any such entries from tfvars files that you copied from an earlier baseline, to avoid an undeclared-variable warning. The first apply after you update upgrades all add-ons in place through a rolling update, with no expected downtime.
Kubernetes 1.34 in the reference infrastructure. The
```
baseline-example
```
Terraform now provisions Kubernetes 1.34 EKS clusters. To upgrade an existing cluster built from an earlier baseline, apply the updated configuration. EKS upgrades one minor version at a time, so a cluster more than one minor version behind needs intermediate
```
eks_cluster_version
```
steps, with one apply for each. EKS Auto Mode replaces nodes automatically after each control-plane upgrade. The unused
```
addon_pod_identity_agent_version
```
setting is removed, because EKS Auto Mode has the pod-identity agent built in; delete it from tfvars files copied from an earlier baseline.
Hardened ArgoCD installation values. The
```
baseline-example
```
now ships hardened ArgoCD installation values at
```
common/argocd/values.yaml
```
. Without a PodDisruptionBudget, a node drain that evicted two of ArgoCD's three Redis replicas at once left ArgoCD unable to elect a new master, and every application then reported the sync status
```
Unknown
```
with
```
EOF
```
errors. The values add PodDisruptionBudgets,
```
podManagementPolicy: Parallel
```
on the Redis StatefulSet, and CPU and memory requests on Redis (plus its sentinel and HAProxy) and on the ArgoCD controller, server, repo-server, and applicationset containers. The last four previously ran with no requests at all, so a cluster autoscaler could remove the node running ArgoCD's only repo server, which broke manifest generation for every application until the pod was rescheduled.
Action required if you installed ArgoCD by following this example: re-run
```
helm upgrade --install
```
with the updated file. Because
```
podManagementPolicy
```
is immutable, that setting also requires you to delete the Redis StatefulSet once, which makes ArgoCD unavailable for about a minute. Redis is an in-memory cache here, so there's nothing to back up:
```
kubectl delete sts argocd-redis-ha-server
```
Longer node consolidation grace period. The
```
baseline-example
```
NodePools now wait 15 minutes of node underutilization before consolidating a node, instead of 60 seconds. The short grace period made Karpenter repack nodes moments after every deployment rollout and between transformation steps, which evicted application services and in-flight transformation pods while they were in use. If you use these NodePools, re-apply them on existing clusters with
```
kubectl apply -f custom-nodepool.yaml
```
. Underutilized nodes now linger up to 15 minutes longer before scale-down.
S3-native Terraform state locking. The
```
baseline-example
```
now locks Terraform state with the S3-native lock file instead of a DynamoDB table, whose backend setting Terraform has deprecated.
```
just init
```
no longer reads
```
TF_LOCK_TABLE
```
. On an already-initialized checkout, run
```
terraform init -reconfigure
```
once to switch. An existing lock table is no longer used and you can delete it.

No action required

Pipeline automation upgraded to v0.0.73. Job-queue concurrency limits are now set explicitly: at most 2,000 concurrent automation jobs across the platform and ten for each organization. Previously, the service's built-in limits applied. No manifest or secret changes are required.
Bounded Valkey cache memory. The Valkey cache now runs with CPU and memory requests and limits, and with a memory budget of 1 GiB. Previously it had no resource requests, which made it the first pod evicted under node memory pressure. When the budget is exhausted, Valkey refuses new writes instead of evicting data, so nothing — cache entries, queues, or locks — is silently dropped. Services report write errors until memory is freed.
Valkey upgraded to 9.1.1. This upgrade contains security fixes. Valkey storage is ephemeral in this deployment, so the upgrade needs no data preparation. Cached data and queued notifications rebuild when the pod is replaced.
Pinned Terraform CLI version. The
```
baseline-example
```
now includes a
```
.terraform-version
```
file that records the exact Terraform CLI version the example is validated with. Version-manager tools such as tfenv and tenv pick it up automatically. The
```
Terraform >= 1.12.0
```
requirement is unchanged.

Fixed issues

Requiring action

User-scoped API calls work. The access token issued to the
```
sdk
```
,
```
dashboard
```
, and
```
mini-usf
```
clients was missing the
```
sub
```
(user ID) claim, which made user-scoped API calls fail. Those clients now include the
```
basic
```
client scope, so their access tokens carry
```
sub
```
and
```
auth_time
```
.
Action required for existing deployments: this isn't applied automatically, because the
```
unity
```
realm already exists and Keycloak skips the realm import. To add the scope manually:
1. In the Keycloak Admin console, select the unity realm.
2. Go to Clients and open the sdk client.
3. Go to Client scopes > Add client scope, select basic, and add it as Default.
4. Repeat for the dashboard and mini-usf clients.
No redeployment is needed. New sign-ins immediately receive the
```
sub
```
claim.
Keycloak runs with multiple replicas on IPv6. Keycloak now works with more than one replica on IPv6 single-stack clusters. Previously the replicas couldn't reach each other, so additional pods never became ready and blocked the deployment. If extra Keycloak replicas are already stuck unready when you upgrade, delete the remaining old pod once with
```
kubectl delete pod keycloak-0
```
so that all instances restart with the fix.
3D Data Streaming transformations schedule correctly. Fixed 3D Data Streaming transformations stalling with pods stuck
```
Pending
```
forever. This affects only clusters provisioned with the
```
baseline-example
```
custom NodePools: the
```
transformations
```
NodePool carried an
```
argo-workflows=cpu
```
taint that the workflow's memory-escalation retry steps don't tolerate, so no node could be provisioned for them. The taint is removed. If you use those NodePools, re-apply them on existing clusters with
```
kubectl apply -f custom-nodepool.yaml
```
. Clusters with their own node pool setup aren't affected.
Automation apps register on clusters that use the baseline ECR registry. Pulls made with a token refreshed by the ECR token-refresher CronJob were denied (
```
not authorized to perform: ecr:BatchGetImage
```
), because the refresher's IAM role could mint tokens but couldn't pull with them. The role now carries the ECR pull permissions: apply the updated
```
baseline-example
```
Terraform on existing clusters. The
```
SETUP.md
```
command that deploys the CronJob is also fixed to substitute the ArgoCD Helm credentials variable. A CronJob deployed with the previous command crashed with
```
unbound variable
```
after refreshing only two of the three secrets, so re-apply the CronJob with the updated command.

No action required

Faster asset search under load. Reduced the
```
public-api
```
Redis timeout errors (
```
Timeout performing HMGET (5000ms)
```
in the service logs) that slowed asset search and aggregation responses under concurrent load. The service now starts with a larger .NET thread pool and can use up to 2 CPUs instead of 1, so cache responses are processed promptly during request bursts.
Interrupted transformations report as failed. Transformations interrupted by a node disruption, such as a spot reclaim, a node upgrade, or a drain, no longer stay
```
Pending
```
in Asset Manager forever. They now report as failed and you can retry them.
Transformation data transfers retry. Transformation steps that download and upload asset data, including the 3D Data Streaming import-validation step, now retry up to three times instead of failing the whole transformation on a single transient error.
Node consolidation no longer interrupts transformations. Running transformation pods are annotated
```
karpenter.sh/do-not-disrupt: "true"
```
, so Karpenter node consolidation no longer evicts them mid-run. This has no effect on clusters that don't run Karpenter.
Download links use your external domain. Dataset and artifact download links returned by the workspace service now use the deployment's external domain. Previously these links pointed at an in-cluster address (
```
http://uvcs:8000/...
```
) that is unreachable from outside the cluster, so those downloads failed for external clients. In-cluster consumers aren't affected.
Transformation actions pull all required images. Transformation actions could fail with image pull errors on deployments that use a private registry, because several container images required by the built-in automation apps were missing from the registry mirror. All images used by the automation apps are now mirrored by the artifact sync.
Air-gapped mirror includes the deployed Istio proxy image. The registry mirror now includes the Istio proxy image tag that the cluster actually deploys. Previously the mirrored and deployed tags differed.

Version 0.15.0 — July 10, 2026

You must use vpctl 0.12.0 or later to deploy this release. Upgrade vpctl before you pull and deploy the release.

New features

Unity Licensing Server on-premises

The Unity Licensing Server is now deployed on-premises and is reachable at

/licensing

under your application domain. It runs as a stateful service backed by a 10 GiB persistent volume and authenticates against the in-cluster Keycloak. No manifest configuration is required.

The volume must be on block storage, because the embedded database doesn't support NFS-class storage. It provisions on your cluster's default storage class, or on

configuration.kubernetes.storage.defaultStorageClass

when set. If you later need to move it to a different storage class, no data backup is required: remove the licensing server and its volume, redeploy the release, then request and import a new license bundle. For more information about managing the licensing server, refer to Licensing.

On new deployments, the

unity-licensing-server

Keycloak client is created automatically with the ID-token mapper the licensing server requires, and

vpctl secret generate

auto-generates the matching

unity-licensing-server

Kubernetes Secret without operator input.

Action required for existing deployments: the Keycloak client isn't added on upgrade, because the

unity

realm already exists and Keycloak skips the realm import. To add the Keycloak client:

Use upc-cli to generate the client import file. The command requires
```
kubectl
```
access to the cluster:


python3 upc-cli.py --fqdn <your-domain> --no-auth keycloak generate-client-json --output unity-licensing-server-client.json

In the Keycloak Admin console, select the unity realm.
Go to Clients > Import client.
Browse to
```
unity-licensing-server-client.json
```
.
Select Save.

Identity synchronization and entitlements tracking

The platform now deploys scheduled jobs that:

Periodically pull new and updated users, projects, organizations, role mappings, and group roles from your identity provider into Asset Manager.
Take a daily entitlements snapshot.

No manifest configuration is required.

Single-stack IPv6 support

You can now deploy on an IPv6-only Kubernetes cluster. Set

configuration.networking.ipFamily: ipv6

in your manifest:


configuration:  networking:    ipFamily: ipv6

This requires vpctl 0.12.0 or later and Kubernetes 1.29 or later.

Deployments that omit the field keep the IPv4 defaults.

If you provision reference AWS infrastructure from the

baseline-example

Terraform included in the release package, set

enable_ipv6_only = true

to provision an IPv6-only EKS cluster with the required VPC, subnet, and DNS64/NAT64 configuration.

Restricted Pod Security Admission compliance

All Asset Manager workloads now render a security context that complies with the Kubernetes Restricted Pod Security Admission profile:

A non-root user.
No privilege escalation.
All Linux capabilities dropped.
Using the
```
RuntimeDefault
```
seccomp profile.

This means you can deploy the platform into namespaces that enforce the

restricted

profile.

UVCS now runs as a non-root user.

Istio CNI, ztunnel, and the host-metrics node exporter remain privileged by design and need their own namespace exemptions if you enable enforcement.

Improvements

Pipeline automation upgraded to v0.0.72. This version adds a new secret: run
```
vpctl secret generate
```
(press Enter to auto-generate the value) and redeploy. The automation database migration runs automatically on deploy, so you need to snapshot your automation PostgreSQL database first. Leave the generated value unchanged on future upgrades.
Configurable in-cluster DNS service name. The new
```
configuration.kubernetes.dnsService
```
manifest field (default
```
kube-dns
```
) overrides the in-cluster DNS service name that the Loki log-collection gateway resolves against. If the
```
loki-gateway
```
pod crash-loops with the error
```
host not found in resolver
```
, set the field to your Kubernetes distribution's CoreDNS service, for example
```
rke2-coredns-rke2-coredns
```
on RKE2. EKS, AKS, and k3s deployments keep the default.
Multiple deployments in one AWS account. The
```
baseline-example
```
Terraform now supports running several deployments in the same AWS account without ECR or IAM name collisions. Use a distinct
```
project_name
```
for each project within a region, and IAM role names are now region-qualified so the same project can also deploy across regions. ECR repositories are namespaced for each project through the new
```
ecr_repository_prefix
```
variable, which defaults to
```
project_name
```
; set your manifest's
```
configuration.kubernetes.docker.namespace
```
to the same value.

Fixed issues

Sign-on flows and OIDC discovery use your public domain. Fixed sign-on flows redirecting to an unreachable
```
http://keycloak
```
URL, and in-cluster services discovering unreachable Keycloak OIDC endpoints. The bundled Keycloak 26 ignores the deprecated hostname options the chart previously set, so OIDC URLs were built from the request host instead of your public domain. The chart now pins the public frontend URL; in-cluster requests keep resolving internally.
Project creation works. Fixed project creation failing with a 404 error. The bundled Traefik routes were missing the create-project endpoint, so creating a new project failed. This didn't impact management of existing projects.
Traefik installs without middleware conflicts. Fixed a Traefik installation failure (
```
Middleware ... already exists
```
) caused by duplicate data-streaming route definitions. The deprecated data-streaming
```
tiles
```
path (
```
.../instances/tiles/{tileId}
```
) is removed; instead, use the
```
groups
```
path (
```
.../instances/groups/{groupId}
```
), which returns the same backend response.
3D Data Streaming workflows use the correct image. The 3DDS storage-tool step previously had no container image configured, so the workflow failed at runtime.
Configuration changes restart UVCS and the licensing server. The Unity Version Control (UVCS) and Unity Licensing Server pods now restart automatically when their configuration changes on upgrade. Previously, a configuration change was applied but the running pod kept serving the old configuration until you restarted it manually.
Asset storage uses the in-cluster message broker. The
```
asset-storage
```
service now connects to the in-cluster RabbitMQ broker for its service message queue.

Version 0.14.0 — June 3, 2026

New features

Deploy charts in parallel

vpctl release deploy

can now deploy independent charts within the same deployment wave in parallel, which reduces total deployment time. Pass

--concurrency N

on the command line, or set a default value for your environment in the manifest:


deployment:  helm:    concurrency: 4

The default value is

, which deploys charts sequentially. Existing behavior remains unchanged unless you enable parallel deployment. If you set a concurrency value greater than

vpctl

buffers each chart's output and displays it after that chart finishes. As a result, the output order differs from sequential deployments. At the end of each deployment wave and after the deployment completes,

vpctl

displays a summary of successful and failed deployments.

Select hardened images in the manifest

You can now select the container image variant in your manifest with the new

configuration.imageVariant

field. Set the value to

hardened

to receive the hardened image builds:


configuration:  imageVariant: hardened

Previously, release packaging automatically applied the hardened image suffix. You now select either the base or hardened images directly in the manifest, which lets you deploy both image variants from the same release.

Action required: If you use hardened images, set

configuration.imageVariant: hardened

in your manifest before you upgrade. Otherwise, the deployment uses the base images.

Deploy in single-node infrastructure mode

Use the new

configuration.infrastructure.singleNode

option to collapse the stateful infrastructure components Garage, PostgreSQL (Percona), MongoDB (Percona), Elasticsearch (ECK), and RabbitMQ to a single replica each. This option also disables PodDisruptionBudgets and removes hard anti-affinity:


configuration:  infrastructure:    singleNode: true

Use this option for single-node or constrained clusters that you use for ephemeral testing and evaluation environments. Don't use it in production environments. Resource sizing, monitoring, backups, and component-specific overrides continue to work as before.

Configurable Traefik node ports

Kubernetes now assigns Traefik node ports for the

web

and

websecure

entry points by default instead of using the previously hardcoded

port for

web

. Existing deployments keep their current node ports after you upgrade because Kubernetes doesn't reassign a node port when the chart no longer requests a specific value.

If your firewall or external load balancer requires a fixed port, set the new

configuration.networking.ingress.traefik.nodePorts

field. Each value must be within the

30000-32767

range:


configuration:  networking:    ingress:      traefik:        nodePorts:          web: 32080

This field requires

vpctl

0.11.0 or later. Earlier versions reject the manifest during validation with the error

nodePorts: field not allowed

Improvements

Keycloak supports upstream TLS termination. If an upstream load balancer terminates TLS, such as an NLB with an ACM certificate, and
```
configuration.networking.ingress.traefik.tls.enabled
```
is set to
```
false
```
, Traefik now forwards the correct HTTPS headers on the secure entry point. Previously, the Keycloak admin console redirected users to an unreachable
```
http://
```
URL and rejected sign-ins.
Garage starts successfully on the first deployment. On a new installation, Garage pods could remain in a not-ready state because their health probes checked a cluster-level endpoint that remained unavailable until the bootstrap job completed. At the same time, the bootstrap job waited for the pods to become ready, which created a deadlock. The health probes have been removed to resolve this issue.
Monitoring resources deploy only when Prometheus is enabled. The
```
secret-manager
```
and
```
argo-workflows
```
charts previously created
```
ServiceMonitor
```
resources even when Prometheus was disabled. Deployments without the Prometheus Operator failed with the error
```
no matches for kind "ServiceMonitor"
```
. These resources are now gated on
```
configuration.monitoring.prometheus.enabled
```
.
Traefik installs correctly in custom namespaces. Two issues that could prevent Traefik from installing have been fixed. The CORS-preflight middlewares on the public data-streaming routes now use distinct names, and the API path rewrite middleware now deploys to your installation namespace instead of a hardcoded namespace. As a result, installations in custom namespaces no longer fail because of namespace conflicts or duplicate middleware resources.
Automation app registration succeeds. The
```
automation-manager
```
post-install job previously entered a crash loop with the error
```
mkdir /.docker: permission denied
```
because the non-root container didn't have a writable home directory for registry credentials. The job now authenticates successfully with your container registry. No action is required other than redeploying the release.
Updated UVCS server and stronger password validation. Updated the UVCS server to version
```
11.0.16.10181
```
. UVCS user and administrator passwords must now contain at least 32 characters. If you provide or import your own passwords,
```
vpctl secret generate
```
rejects shorter passwords before deployment instead of allowing the deployment to fail later with an authorization error. Automatically generated passwords already meet this requirement.
Use one private CA for ingress TLS and client authentication. The certificate generation helper script can now issue the Traefik ingress certificate from the same private CA that it uses for X.509 client certificates. This change makes it easier to configure a fully private CA deployment, such as an internal or government PKI.

Version 0.13.0 — May 12, 2026

New features

Garage object storage replaces RustFS

The on-premises deployment now uses Garage as the S3-compatible object store, replacing RustFS. Garage runs as a 3-node distributed cluster (

replicationFactor: 3

) in all sizing profiles by default, and it stores Argo workflow artifacts and Percona MongoDB scheduled backups in its

argo-artifacts

and

psmdb-backups

buckets.

Use the new

configuration.infrastructure.components.garage

manifest field to configure Garage. The available settings are

resources

(standard CPU and memory requests and limits),

metaStorage

dataStorage

replicas

, and

replicationFactor

(capped at 3).

Requirements:

vpctl 0.10.0 or later.
At least 3 schedulable nodes in the general workloads pool. MongoDB and RabbitMQ already require this minimum because they spread their three replicas across distinct nodes by using
```
podAntiAffinity
```
. Garage uses the same model.

For the upgrade procedure and data preservation paths, refer to the Breaking change section that follows.

Customer-supplied CA bundle for internally-signed TLS

A new

configuration.networking.trustedCaSecretName

manifest field lets you mount your CA chain into the Argo workflow containers, the StorageTool, and all

asset-manager-*

Pixyz workflow templates. Use it when your Asset Manager ingress presents a TLS certificate signed by a private CA, such as a DoD PKI or an internal corporate CA, instead of a publicly trusted CA.

Reference a pre-existing Kubernetes Secret that holds a PEM-encoded CA bundle under the single key

ca-bundle.crt


configuration:  networking:    trustedCaSecretName: my-ca-bundle

The .NET workflow containers and the Pixyz workflow templates pick up the bundle when they start.

Improvements

Larger default PostgreSQL storage. This release increases default PostgreSQL data and pgBackRest backup persistent volume sizes by sizing profile: 50 GiB data and 100 GiB backup (
```
small
```
), 400 GiB data and 800 GiB backup (
```
medium
```
), 800 GiB data and 1600 GiB backup (
```
large
```
). For existing clusters, ensure your StorageClass has
```
allowVolumeExpansion: true
```
so that the Percona PostgreSQL operator can resize the PVCs online; otherwise, resize the PVCs manually after upgrading.
Automation step logs stream again. The
```
automation-external-secrets
```
Secret now also includes
```
AWS_ACCESS_KEY_ID
```
and
```
AWS_SECRET_ACCESS_KEY
```
, mirrored from
```
s3-api-storage-credentials
```
, which the AutomationService needs to stream Argo step logs from object storage. After upgrading, rerun
```
vpctl secret generate
```
and
```
vpctl secret deploy
```
, then run
```
kubectl -n asset-solutions rollout restart deployment/automation
```
so that the AutomationService picks up the new environment variables.

Breaking change

RustFS replaced by Garage

This release removes the

configuration.infrastructure.components.rustfs

manifest field. The S3-compatible object store is now Garage and uses the new

configuration.infrastructure.components.garage

manifest field. You must use vpctl

0.10.0

or later to deploy this release.

Customer-visible side effects

The
```
s3-api-storage-credentials
```
Kubernetes Secret keeps its name, but the field names changed:
```
RUSTFS_ACCESS_KEY
```
is now
```
GARAGE_ACCESS_KEY
```
, and
```
RUSTFS_SECRET_KEY
```
is now
```
GARAGE_SECRET_KEY
```
. The
```
AWS_ACCESS_KEY_ID
```
and
```
AWS_SECRET_ACCESS_KEY
```
aliases still mirror those values for the Percona MongoDB operator. After upgrading vpctl, rerun
```
vpctl secret generate
```
and
```
vpctl secret deploy
```
to pick up the new schema.
A new
```
garage-rpc-secret
```
Kubernetes Secret (single field
```
rpcSecret
```
, 64-character hex) holds the Garage cluster RPC secret. The Garage chart consumes it through
```
existingRpcSecret
```
. vpctl creates this Secret automatically as part of
```
vpctl secret generate
```
— no extra action is required beyond the standard first-time deploy flow.
Percona MongoDB scheduled backups now write to the Garage
```
psmdb-backups
```
bucket through
```
garage:3900
```
. There's no manifest-level change required.
The
```
/rustfs
```
Traefik debug ingress route is removed. To reach the S3 API directly, use
```
kubectl port-forward svc/garage 3900:3900
```
.

Migration paths

Choose one of these paths before you run

vpctl release deploy

Path A — wipe and redeploy (recommended for staging environments). RustFS object data isn't preserved. Argo workflow artifacts are ephemeral, Percona MongoDB regenerates backups on the next scheduled run, and Asset Manager re-ingests content on demand.

Before you continue with the rest of the upgrade guide, drain the RustFS PVCs:


kubectl -n asset-solutions delete pvc -l app.kubernetes.io/name=rustfs

Then return to the upgrade guide and complete steps 4 (sync artifacts), 5 (regenerate and deploy secrets), and 6 (regenerate and deploy charts). When

vpctl release deploy

completes, Garage replaces RustFS in the same release, and the

garage-bucket-bootstrap

post-sync Job assigns the cluster layout, imports your

GARAGE_ACCESS_KEY

and

GARAGE_SECRET_KEY

into Garage, and creates the

argo-artifacts

and

psmdb-backups

buckets.

Path B — preserve data with
mc mirror
. Recommended if you want to keep existing PSMDB backup dumps. This release includes a helper script,

migrate-rustfs-to-garage.sh

, under

extracted-release/common/scripts/

Before you regenerate and deploy the new secrets (step 5 in the upgrade guide), run the backup phase from a workstation that can reach the cluster. At this point, the in-cluster

s3-api-storage-credentials

Secret still holds the old

RUSTFS_*

fields, so the script can mirror the

argo-artifacts

and

psmdb-backups

buckets from RustFS to a local directory:


export RUSTFS_ACCESS_KEY=$(kubectl -n asset-solutions get secret s3-api-storage-credentials -o jsonpath='{.data.RUSTFS_ACCESS_KEY}' | base64 -d)export RUSTFS_SECRET_KEY=$(kubectl -n asset-solutions get secret s3-api-storage-credentials -o jsonpath='{.data.RUSTFS_SECRET_KEY}' | base64 -d)NAMESPACE=asset-solutions BACKUP_DIR=./rustfs-backup ./extracted-release/common/scripts/migrate-rustfs-to-garage.sh backup

Return to the upgrade guide and complete steps 5 (regenerate and deploy secrets) and 6 (regenerate and deploy charts). After

vpctl release deploy

finishes and both the Garage StatefulSet and the

garage-bucket-bootstrap

Job are complete, restore the buckets to Garage:


export GARAGE_ACCESS_KEY=$(kubectl -n asset-solutions get secret s3-api-storage-credentials -o jsonpath='{.data.GARAGE_ACCESS_KEY}' | base64 -d)export GARAGE_SECRET_KEY=$(kubectl -n asset-solutions get secret s3-api-storage-credentials -o jsonpath='{.data.GARAGE_SECRET_KEY}' | base64 -d)NAMESPACE=asset-solutions BACKUP_DIR=./rustfs-backup ./extracted-release/common/scripts/migrate-rustfs-to-garage.sh restore

Version 0.12.0 — April 30, 2026

Improvements

Hardened UVCS container security

The

uvcs

(previously Plastic SCM) StatefulSet now runs as a non-root user (UID 1000) with a hardened security context. This disables privilege escalation, drops all Linux capabilities, and enforces the

RuntimeDefault

seccomp profile. This change lets you deploy in clusters that enforce strict Pod Security Standards or Kyverno policies that forbid

runAsUser: 0

Action required before you upgrade existing deployments

Plan a maintenance window. On the first
```
uvcs
```
pod restart after the upgrade, Kubernetes recursively changes ownership of the
```
uvcs
```
persistent volume (
```
/jet
```
) to GID 1000 through
```
fsGroupChangePolicy: OnRootMismatch
```
. For large repositories, this operation can take several minutes, during which the
```
uvcs
```
pod is unavailable.
Validate that your CSI driver applies
fsGroup
correctly.
Verify the upgrade. After the upgrade completes, confirm the new security context:
- ```
kubectl exec uvcs-0 -c uvcs -- id
```
  returns
```
uid=1000 gid=1000
```
  .
- ```
kubectl exec uvcs-0 -c uvcs -- ls -ld /jet
```
  shows group
```
1000
```
  and no permission errors.
- ```
kubectl logs uvcs-0 -c uvcs
```
  shows the entrypoint creating symlinks under
```
/opt/plasticscm5/server
```
  without errors and
```
plasticd
```
  binding
```
:8087
```
  .

Version 0.11.0 — April 24, 2026

New features

Helm chart sourcing (preview)

The new

deployment.helmChartMode

manifest setting lets you choose how Helm charts are delivered:

```
local
```
(default): the process installs charts from the release package. This is the safest option for existing deployments and for air-gapped environments.
```
remote
```
: the process pulls charts from an OCI Helm registry at deployment time.

The

remote

mode and the matching

vpctl artifact sync charts

command are available as a preview in this release. Not all charts are published to the Unity OCI Helm registry yet, so a fully remote-only deployment isn't supported. For production deployments, continue to use the default

local

mode.

Default monitoring alerts

The Prometheus monitoring stack now ships with a curated set of cluster and workload alerting rules out of the box. You no longer need to assemble these rules manually before going to production.

Hardened container variant for the upc-job image

The

upc-job

image now ships in a hardened variant, which is built on a minimal base image with a reduced attack surface for stricter security baselines.

Improvements

Higher default resource allocations: MongoDB, mini-usf, and public-api now request more CPU and memory by default, which reduces the need for manual tuning to reach production-level performance.
Idempotent onboarding: the
```
upc-onboarding
```
job is now safe to rerun. The job no longer fails or duplicates resources if you retrigger it after a partial deployment.
More resilient RabbitMQ scheduling: RabbitMQ pods now schedule successfully on clusters that don't expose availability zone labels.
Reliable Keycloak tokens: Keycloak-issued tokens now include the
```
sub
```
and
```
auth_time
```
claims required by downstream services. This fixes a regression introduced by Keycloak 26's stricter scope handling.
Mini-usf routing fixes: legacy admin routes and the groups routes are now matched correctly, including the right middlewares and permissions for the global admin role.
Quieter object storage logs: RustFS no longer floods the log volume at default verbosity. The default log level is now
```
error
```
, which prevents disk pressure on the log PVC.
Organization management connectivity: the
```
organization-management
```
service now reads the correct RabbitMQ consumer queue setting and starts cleanly.

Version 0.10.0 — March 20, 2026

New features

Official Keycloak 26 image

The identity stack now runs the official Keycloak 26 image through the new keycloak-standalone chart, replacing the previous Bitnami-based Keycloak distribution. This change brings access to upstream Keycloak features and a faster security update cadence.

If you previously customized the Bitnami Keycloak chart, review your manifest before upgrading.

Automation app scheduling

A new

uc-scheduler-runner

image powers scheduled jobs for automation apps such as Asset Manager and Pixyz. Scheduling now runs as part of the deployment without additional manual setup.

Improvements

The fallback namespace used for automation resource isolation (
```
UCAUTOMATION_ResourceIsolationOptions__FallbackNamespace
```
) now follows the namespace defined in your manifest instead of being hardcoded. Multi-namespace deployments work without code changes.

Version 0.9.0 — March 17, 2026

New features

Automation app management

Automation apps such as Asset Manager and Pixyz are now automatically registered during deployment. A post-deployment job handles app registration, removing the need for manual setup.

Version 0.8.0 — March 13, 2026

New features

Log storage configuration

You can now control the persistent volume size for log storage independently from data storage for the object storage component. Sizing profile defaults range from 1 GiB (

small

) to 10 GiB (

large

), and you can override the value per component.

Transformation parallelism control

A new

configuration.transformations.parallelism

manifest field lets you set the maximum number of concurrent transformation workflows. The default value is 20.

Improvements

Deployment validation now enforces that the store encryption key is exactly 32 characters, catching misconfigured keys before they cause runtime errors.

Breaking change

The

configuration.licensing

section, including FlexLM and

sdkLicenses

settings, has been removed. Built-in transformation workflows are now always enabled, and their concurrency is controlled through the new

configuration.transformations.parallelism

manifest field. Remove any licensing configuration from your manifest before upgrading.

Version 0.7.0 — March 3, 2026

New features

CLI version compatibility checks

The release package now declares the minimum required

vpctl

version. The

vpctl release generate

and

vpctl secret generate

commands check this requirement before running and block execution if the CLI version is too old. This prevents silent misconfigurations from manifest schema changes.

Improvements

Object storage distributed mode

Object storage now runs in distributed mode by default, improving data durability and availability.

Version 0.6.0 — February 23, 2026

New features

Infrastructure sizing profiles

You can now control the CPU, memory, and storage allocations for the following infrastructure components directly from the manifest: MongoDB, PostgreSQL, RabbitMQ, object storage, and Elasticsearch.

Choose from three named sizing profiles:

small

medium

, or

large

. Alternatively, override the resources for individual components to match your workload.

Improved container image management

All infrastructure images, including Istio and Percona MongoDB backup images, are now sourced from your private container registry instead of public registries. This method improves reliability and security in air-gapped or restricted network environments.

Breaking change

Support for the custom Pixyz scripts has been removed. If you previously used the

automation.customPixyzScript

manifest configuration, remove it from your manifest before upgrading.

Version 0.5.0 — February 17, 2026

New features

Centralized log collection

Log collection is now available through Loki and Alloy. Enable it in your manifest with the

monitoring.logCollection.enabled

option to aggregate logs from all services in your deployment.

Improvements

Automated MongoDB backups

Percona MongoDB now automatically backs up data to RustFS S3-compatible storage, improving data durability without requiring manual backup configuration.

Version 0.4.0 — February 12, 2026

New features

Istio service mesh support

You can now enable Istio with ambient mode for service-to-service traffic management and observability. Configure Istio in your manifest under

configuration.networking.serviceMesh.istio

SDK license management

A new

sdkLicenses

setting in the manifest licensing section lets you specify how many Pixyz SDK licenses are available. This setting controls the maximum number of concurrent transformation workflows.

Improvements

Improved container image handling for workflow execution
Improved object storage reliability with automated bucket creation during deployment

Version 0.3.0 — January 28, 2026

New features

Full application suite

This release adds the complete set of application services, including:

Asset Manager: full asset management with storage, collaboration, and search
Automations and workflows: pipeline automation with Argo Workflows
Identity and access management: Keycloak for authentication and role-based access control
Notifications: event notifications through Novu
Ingress: Traefik as the ingress controller and load balancer

Version 0.2.0 — December 8, 2025

New features

Core infrastructure services

This release adds the foundational infrastructure layer, including:

Databases: PostgreSQL (via PG Operator) and Elasticsearch for relational data and search
Caching: Valkey for in-memory data storage
Messaging: RabbitMQ for asynchronous communication
Asset services: storage abstraction, collaboration, authoring, bulk operations, and catalog management

Version 0.1.0 — November 28, 2025

New features

First release of Self-Hosted Deployment On-Premises.